{"id":13406174,"url":"https://github.com/frappe/books","last_synced_at":"2025-05-13T20:17:16.373Z","repository":{"id":38107622,"uuid":"116673933","full_name":"frappe/books","owner":"frappe","description":"Free Accounting Software","archived":false,"fork":false,"pushed_at":"2025-05-08T12:20:34.000Z","size":16429,"stargazers_count":3297,"open_issues_count":125,"forks_count":776,"subscribers_count":84,"default_branch":"master","last_synced_at":"2025-05-08T13:29:12.897Z","etag":null,"topics":["accounting","book-keeping","desktop","double-entry-accounting","electron","frappe","inventory-management","invoicing","javascript","offline","open-source","point-of-sale","vuejs"],"latest_commit_sha":null,"homepage":"https://frappe.io/books","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frappe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-01-08T12:29:11.000Z","updated_at":"2025-05-08T12:20:38.000Z","dependencies_parsed_at":"2023-02-15T07:16:31.291Z","dependency_job_id":"d3ef3030-e203-44ce-91be-8ea2c1ee32d5","html_url":"https://github.com/frappe/books","commit_stats":{"total_commits":2752,"total_committers":75,"mean_commits":"36.693333333333335","dds":0.5443313953488372,"last_synced_commit":"4c1fa7cbb39f1e2738dcef2eef7c4a0b40b288f8"},"previous_names":[],"tags_count":74,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Fbooks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Fbooks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Fbooks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Fbooks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frappe","download_url":"https://codeload.github.com/frappe/books/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254020653,"owners_count":22000757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accounting","book-keeping","desktop","double-entry-accounting","electron","frappe","inventory-management","invoicing","javascript","offline","open-source","point-of-sale","vuejs"],"created_at":"2024-07-30T19:02:23.208Z","updated_at":"2025-05-13T20:17:11.365Z","avatar_url":"https://github.com/frappe.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Accounting","Vue","🌐 Web Development - Frontend","electron"],"sub_categories":["Bookkeeping"],"readme":"\u003cdiv align=\"center\" markdown=\"1\"\u003e\n\u003cbr/\u003e\n\n\u003cimg src=\"https://frappe.io/files/books.png\" alt=\"Frappe Books logo\" width=\"80\"/\u003e\n\n\u003cbr/\u003e\n\n\u003ch1\u003eFrappe Books\u003c/h1\u003e\n\n**Modern Accounting Made Simple**\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/frappe/books)](https://github.com/frappe/books/releases)\n![Platforms](https://img.shields.io/badge/platform-mac%2C%20windows%2C%20linux-yellowgreen)\n[![Publish](https://github.com/frappe/books/actions/workflows/publish.yml/badge.svg)](https://github.com/frappe/books/actions/workflows/publish.yml)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/29507195/207267857-4ae48890-3fb2-4046-80cf-3256b46c72a0.png\" alt=\"Frappe Books Preview\"/\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\t\u003ca href=\"https://frappe.io/books\"\u003eWebsite\u003c/a\u003e\n\t-\n\t\u003ca href=\"https://docs.frappe.io/books\"\u003eDocumentation\u003c/a\u003e\n\u003c/div\u003e\n\n## Frappe Books\n\nFrappe Books is an open-source accounting software aimed at simplifying financial management for businesses. With its clean and user-friendly interface, it streamlines accounting tasks for small and medium-sized enterprises, offering a seamless solution for modern businesses to manage their finances with ease.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshots\u003c/summary\u003e\n\u003cbr/\u003e\n\u003cimg alt=\"Pos\" src=\"https://github.com/user-attachments/assets/f75116b4-cf5f-45ee-9927-ba380fa56a46\" /\u003e\n \u003cbr/\u003e\u003cbr/\u003e\n \u003cimg alt=\"General Ledger\" src=\"https://github.com/user-attachments/assets/58d8bcdf-1576-4008-b010-7054fb64a12d\" /\u003e\n \u003cbr/\u003e\u003cbr/\u003e\n \u003cimg alt=\"Profit and Loss\" src=\"https://github.com/user-attachments/assets/11bd67d1-d808-496b-ac4d-ef68c18b9419\" /\u003e\n\n\u003c/details\u003e\n\n### Motivation\n\nFrappe Books addresses a market gap where small businesses face expensive, complex accounting tools. It offers an intuitive, open-source solution that combines simplicity with essential features, empowering businesses to manage finances effectively—even offline.\n\n### Key Features\n\n- **Dashboard**: Provides an overview of key financial data and performance metrics.\n- **Point of Sale**: Simplifies retail transactions with an integrated POS system for easy sales processing.\n- **Works Offline**: Enables users to continue working without an internet connection and sync later.\n- **Double-entry accounting**: Ensures accurate financial tracking by recording each transaction in two accounts.\n- **Entries**\n - **Invoicing**: Allows businesses to create and manage professional invoices effortlessly.\n - **Billing**: Billing processes by generating bills and tracking payments.\n - **Payments**: Records and tracks payments received and made.\n - **Journal Entries**: Records financial transactions in the general ledger with detailed notes and adjustments.\n- **Financial Reports**\n - **General Ledger**: Centralized record of all financial transactions, providing a comprehensive view of accounts.\n - **Profit and Loss Statement**: Summarizes revenues, costs, and expenses to show business profitability.\n - **Balance Sheet**: Displays a company’s assets, liabilities, and equity at a specific point in time.\n - **Trial Balance**: Verifies the accuracy of accounting records by ensuring that debits and credits are balanced.\n \u003cbr/\u003e\n\n### Under the Hood\n\n- **Vue.js**: In Frappe Books, Vue.js powers the front-end, enabling a reactive and component-based UI. It ensures seamless interactions and dynamic updates, giving users a modern, responsive experience.\n\n- **Electron**: Electron is used to package Frappe Books as a standalone desktop application, allowing it to run offline and provide a native-like experience across Windows, macOS, and Linux.\n\n- **SQLite**: Frappe Books uses SQLite as its local database. All financial data, transactions, and configurations are stored securely in an SQLite file on the user's machine.\n\n## Production Setup\n\n### Manual\n\nDownload and install the latest release for your platform from the [releases\npage](https://github.com/frappe/books/releases) .\n\n### Using Homebrew (for MacOS and Linux)\n\n```zsh\nbrew install --cask frappe-books\n```\n\n### Via Flatpak (Linux)\n\n\u003ca href='https://flathub.org/apps/io.frappe.books'\u003e\n \u003cimg width='120' alt='Get it on Flathub' src='https://flathub.org/api/badge?locale=en'/\u003e\n\u003c/a\u003e\n\n## Development Setup\n\n### Pre-requisites\n\nTo get the dev environment up and running you need to first set up Node.js `v20.18.1` and npm. For this, we suggest using\n[nvm](https://github.com/nvm-sh/nvm#installing-and-updating).\n\nNext, you will need to install [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable).\n\n### Clone and Run\n\nOnce you are through the Pre-requisites, you can run the following commands to\nsetup Frappe Books for development and building:\n\n```bash\n# clone the repository\ngit clone https://github.com/frappe/books.git\n\n# change directory\ncd books\n\n# install dependencies\nyarn\n```\n\nTo run Frappe Books in development mode (with hot reload, etc):\n\n```bash\n# start the electron app\nyarn dev\n```\n\n**Note: First Boot**\n\nWhen you run `yarn dev` electron will run immediately but the UI will take a\ncouple of seconds to render this because of how dev mode works. Each file is\nindividually served by the dev server. And there are many files that have to be\nsent.\n\n**Note: Debug Electron Main Process**\n\nWhen in dev mode electron runs with the `--inspect` flag which allows an\nexternal debugger to connect to port 5858. You can use chrome for this by\nvisiting `chrome://inspect` while Frappe Books is running in dev mode.\n\nSee more [here](https://www.electronjs.org/docs/latest/tutorial/debugging-main-process#external-debuggers).\n\n#### Build\n\nTo build Frappe Books and create an installer:\n\n```bash\n# start the electron app\nyarn build\n```\n\n**Note: Build Target**\nBy default the above command will build for your computer's operating system and\narchitecture. To build for other environments (example: for linux from a windows\ncomputer) check the _Building_ section at\n[electron.build/cli](https://www.electron.build/cli).\n\nSo to build for linux you could use the `--linux` flag like so: `yarn build --linux`.\n\n## Want to Just Try Out or Contribute?\n\nIf you want to contribute to Frappe Books, please check our [Contribution Guidelines](https://github.com/frappe/books/blob/master/.github/CONTRIBUTING.md). There are many ways you can contribute even if you don't code:\n\n1. If you find any issues, no matter how small (even typos), you can [raise an issue](https://github.com/frappe/books/issues/new) to inform us.\n2. You can help us with language support by [contributing translations](https://github.com/frappe/books/wiki/Contributing-Translations).\n3. If you're an ardent user you can tell us what you would like to see.\n4. If you have accounting requirements, you can become an ardent user. 🙂\n\nIf you want to contribute code then you can fork this repo, make changes and raise a PR. ([see how to](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork))\n\n## Translation Contributors\n\n| Language | Contributors | |\n| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |\n| Arabic | [taha2002](https://github.com/taha2002), [Faridget](https://github.com/faridget) | |\n| Catalan | DĂ­dac E. JimĂ©nez | |\n| Chinese - Simplified | [wcxu21](https://github.com/wcxu21), [wolone](https://github.com/wolone), [Ji Qu](https://github.com/winkidney) | |\n| Chinese - Traditional | [Ethan Deng](https://github.com/ethandengs) | |\n| Danish | [Tummas Joensen](https://github.com/slang123) | |\n| Dutch | [RijckAlex](https://github.com/RijckAlex), [Stan M](https://github.com/stxm) | |\n| French | [DeepL](https://www.deepl.com/), [mael-chouteau](https://github.com/mael-chouteau), [joandreux](https://github.com/joandreux) | |\n| German | [DeepL](https://www.deepl.com/), [barredterra](https://github.com/barredterra), [promexio](https://github.com/promexio), [C2H6-383](https://github.com/C2H6-383), [0xflotus](https://github.com/0xflotus) | |\n| Gujarati | [dhruvilxcode](https://github.com/dhruvilxcode), [4silvertooth](https://github.com/4silvertooth) | |\n| Hindi | [bnsinghgit](https://github.com/bnsinghgit) | |\n| Indonesian | [Aji Prakoso](https://github.com/jipraks) | |\n| Korean | [Isaac-Kwon](https://github.com/Isaac-Kwon) | |\n| Portuguese | [DeepL](https://www.deepl.com/), [Valdir Amaral](https://github.com/valdir-amaral) | |\n| Spanish | [talmax1124](https://github.com/talmax1124), [delbertf](https://github.com/delbertf) | |\n| Swedish | [papplo](https://github.com/papplo), [Crims-on](https://github.com/Crims-on) | |\n| Turkish | Eyuq, [XTechnology-TR](https://github.com/XTechnology-TR) | |\n\n## Learn and connect\n\n- [Telegram Group](https://t.me/frappebooks): Used for discussions and decisions regarding everything Frappe Books.\n- [GitHub Discussions](https://github.com/frappe/books/discussions): Used for discussions around a specific topic.\n- [Documentation](https://docs.frappe.io/books): Offaicial documentation for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrappe%2Fbooks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrappe%2Fbooks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrappe%2Fbooks/lists"}