# Developer docs Contributor, developer, and maintainer docs. These aim to describe and communicate the structure, processes and workflows of the hledger project - "the machine that makes the machine". These mostly are kept in doc/ in the main hledger repo, and then symlinked into the hledger_site repo for rendering on hledger.org. - [Contributor Quick Start](CONTRIBUTING.md) - [Developer FAQ](DEVFAQ.md) - [Project README](dev-README.md) - [ROADMAP](ROADMAP.md) - [ACHIEVEMENTS](ACHIEVEMENTS.md) - [BENCHMARKS](BENCHMARKS.md) - [CHANGELOGS](CHANGELOGS.md) - [CLIMATE](CLIMATE.md) - [CODE](CODE.md) - [COMMITS](COMMITS.md) - [CREDITS](CREDITS.md) - [DECISIONS](DECISIONS.md) - [DEVWORKFLOWS](DEVWORKFLOWS.md) - [DOCS](DOCS.md) - [ERRORS](ERRORS.md) - [EXAMPLES](EXAMPLES.md) - [FILES](FILES.md) - [FINANCE](FINANCE.md) - [Investment Accounting Feature Ladder](investment-accounting-features.md) - [ISSUES](ISSUES.md) - [JUST-MAKE-SHAKE](JUST-MAKE-SHAKE.md) - [LINKS](LINKS.md) - [MOCKUPS](MOCKUPS.md) - [PULLREQUESTS](PULLREQUESTS.md) - [REGRESSIONS](REGRESSIONS.md) - [RELEASING](RELEASING.md) - [REPOS](REPOS.md) - [TESTS](TESTS.md) - [VERSIONNUMBERS](VERSIONNUMBERS.md) ## Dev links **Discussion:** \ \ **Github:**\ main repo: [commits](https://github.com/simonmichael/hledger/commits), , , , , , [ISSUES](ISSUES.md) , , , , , [PULLREQUESTS](PULLREQUESTS.md) [star-history.com](https://star-history.com/#simonmichael/hledger&ledger/ledger&beancount/beancount&Date) PTA apps' github star history\ [stars.hledger.org](https://stars.hledger.org) our rank among github-starred haskell projects: | | | |------|-----| | 2025 | #22 | | 2023 | #32 | | 2022 | #34 | | 2020 | #36 | | 2018 | #53 | | 2017 | #54 | | 2016 | #71 | site repo: finance repo: related repos:\ [![Github topic: #hledger](https://img.shields.io/badge/Github_topic-%23hledger-green)](https://github.com/topics/hledger?o=desc&s=updated)\ [![Github topic: #plaintext-accounting](https://img.shields.io/badge/Github_topic-%23plaintext--accounting-green)](https://github.com/topics/plaintext-accounting?o=desc&s=updated)\ [![Github topics: *accounting*](https://img.shields.io/badge/Github_topics-%2Aaccounting%2A-green)](https://github.com/search?type=topics&q=accounting)\ \ **Hackage:**\ packages: [hledger-lib](https://hackage.haskell.org/package/hledger-lib), [hledger](https://hackage.haskell.org/package/hledger), [hledger-ui](https://hackage.haskell.org/package/hledger-ui), [hledger-web](https://hackage.haskell.org/package/hledger-web), [hledger-diff](https://hackage.haskell.org/package/hledger-diff), [hledger-iadd](https://hackage.haskell.org/package/hledger-iadd), [hledger-interest](https://hackage.haskell.org/package/hledger-interest), [hledger-irr](https://hackage.haskell.org/package/hledger-irr), [\*hledger\*](https://hackage.haskell.org/packages/search?terms=hledger)\ diffs: [hledger-lib](https://hdiff.luite.com/cgit/hledger-lib/diff), [hledger](https://hdiff.luite.com/cgit/hledger/diff), [hledger-ui](https://hdiff.luite.com/cgit/hledger-ui/diff), [hledger-web](https://hdiff.luite.com/cgit/hledger-web/diff)\ build status: [hledger-lib](https://matrix.hackage.haskell.org/package/hledger-lib), [hledger](https://matrix.hackage.haskell.org/package/hledger), [hledger-ui](https://matrix.hackage.haskell.org/package/hledger-ui), [hledger-web](https://matrix.hackage.haskell.org/package/hledger-web)\ reverse deps: [hledger-lib](https://packdeps.haskellers.com/reverse/hledger-lib), [hledger](https://packdeps.haskellers.com/reverse/hledger), [hledger-ui](https://packdeps.haskellers.com/reverse/hledger-ui), [hledger-web](https://packdeps.haskellers.com/reverse/hledger-web)\ [![Hackage](https://img.shields.io/hackage/v/hledger.svg?logo=Haskell&label=Hackage&colorB=brightgreen)](https://hackage.haskell.org/package/hledger)\ \ **Stackage:**\ [build-constraints.yaml](https://github.com/fpco/stackage/blob/master/build-constraints.yaml)\ [open hledger-related issues](https://github.com/fpco/stackage/search?q=hledger+is%3Aopen&type=Issues)\ packages: [hledger-lib](https://www.stackage.org/package/hledger-lib), [hledger](https://www.stackage.org/package/hledger), [hledger-ui](https://www.stackage.org/package/hledger-ui), [hledger-web](https://www.stackage.org/package/hledger-web)\ versions: [hledger-lib](https://www.stackage.org/package/hledger-lib/snapshots), [hledger](https://www.stackage.org/package/hledger/snapshots), [hledger-ui](https://www.stackage.org/package/hledger-ui/snapshots), [hledger-web](https://www.stackage.org/package/hledger-web/snapshots)\ [![Stackage LTS](https://repology.org/badge/version-for-repo/stackage_lts/hledger.svg?header=Stackage+LTS)](https://www.stackage.org/lts/package/hledger) [![Stackage LTS](https://repology.org/badge/version-for-repo/stackage_nighly/hledger.svg?header=Stackage+Nightly)](https://www.stackage.org/lts/package/hledger)\ \ **Repology:**\ [quick hledger packaging status](https://repology.org/metapackage/hledger/badges), [detailed hledger packaging status](https://repology.org/project/hledger/versions), [information for hledger](https://repology.org/project/hledger/information), [all \*hledger\* packages](https://repology.org/metapackages/?search=hledger)\ \ **Homebrew:**\ [hledger](https://formulae.brew.sh/formula/hledger)\ our [homebrew requested installs in last 365 days](https://formulae.brew.sh/analytics/install-on-request/365d):\ 2025: #1872 of 26k, top 7%\ 2023: #1821 of 24k, top 8%\ 2020: #1520 of 10k, top 15% \ **Debian:**\ source packages: [haskell-hledger-lib](https://tracker.debian.org/pkg/haskell-hledger-lib), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-lib), [haskell-hledger](https://tracker.debian.org/pkg/haskell-hledger), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger), [haskell-hledger-ui](https://tracker.debian.org/pkg/haskell-hledger-ui), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-ui), [haskell-hledger-web](https://tracker.debian.org/pkg/haskell-hledger-web), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-web)\ stable: [hledger](https://packages.debian.org/stable/hledger), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=stable), [hledger-ui](https://packages.debian.org/stable/hledger-ui), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=stable), [hledger-web](https://packages.debian.org/stable/hledger-web), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=stable)\ testing: [hledger](https://packages.debian.org/testing/hledger), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=testing), [hledger-ui](https://packages.debian.org/testing/hledger-ui), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=testing), [hledger-web](https://packages.debian.org/testing/hledger-web), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=testing)\ unstable: [hledger](https://packages.debian.org/unstable/hledger), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=unstable), [hledger-ui](https://packages.debian.org/unstable/hledger-ui), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=unstable), [hledger-web](https://packages.debian.org/unstable/hledger-web), [bugs](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=unstable)\ all: [\*hledger\*](https://packages.debian.org/search?searchon=names&keywords=hledger)\ Popularity contest install stats: [hledger](https://qa.debian.org/popcon-graph.php?packages=hledger), [hledger-ui](https://qa.debian.org/popcon-graph.php?packages=hledger-ui), [hledger-web](https://qa.debian.org/popcon-graph.php?packages=hledger-web)\ \ **Ubuntu:**\ source packages: [haskell-hledger-lib](https://launchpad.net/ubuntu/+source/haskell-hledger-lib), [bugs](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-lib), [haskell-hledger](https://launchpad.net/ubuntu/+source/haskell-hledger), [bugs](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger), [haskell-hledger-ui](https://launchpad.net/ubuntu/+source/haskell-hledger-ui), [bugs](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-ui), [haskell-hledger-web](https://launchpad.net/ubuntu/+source/haskell-hledger-web), [bugs](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-web)\ binary packages: [\*hledger\*](https://packages.ubuntu.com/search?suite=all&searchon=names&keywords=hledger)\ \ **Gentoo:** [hledger](https://gpo.zugaina.org/dev-haskell/hledger), [hledger-web](https://gpo.zugaina.org/dev-haskell/hledger-web), [\*hledger\*](https://gpo.zugaina.org/Search?search=hledger)\ \ **Fedora:** [hledger](https://apps.fedoraproject.org/packages/hledger), [\*hledger\*](https://apps.fedoraproject.org/packages/s/hledger), [hledger (package db)](https://admin.fedoraproject.org/pkgdb/package/hledger/), [Haskell SIG](https://fedoraproject.org/wiki/Haskell_SIG)\ \ **Void Linux:** [package search](https://voidlinux.org/packages/)->hledger\ \ **Nix:** [\*hledger\*](https://hydra.nixos.org/search?query=hledger)\ \ **Sandstorm:** [hledger web app & reviews](https://apps.sandstorm.io/app/8x12h6p0x0nrzk73hfq6zh2jxtgyzzcty7qsatkg7jfg2mzw5n90), [issues](https://github.com/simonmichael/hledger/issues?utf8=✓&q=label%3A%22platform%3A%20sandstorm%22%20)\ \ **Reference:** [fosskers GHC compatibility chart](https://www.fosskers.ca/en/blog/base)\ \ **Old trello planning board:** \ \ **hledger-web demo:** \ **hledger GHCJS demo:** , \