2
0
mirror of https://github.com/frappe/books.git synced 2024-11-05 13:07:51 +00:00
Free desktop accounting software for small-businesses and freelancers.
Go to file
2024-11-05 09:50:28 +05:30
.github update publish workflow and add intel macos build 2024-10-23 18:20:30 +09:00
backend fix: patch to fix wrong field datatype of hsnCode 2024-11-04 12:33:22 +05:30
build Fixed linting for PR 843 2024-02-11 16:09:35 -08:00
dummy chore: set hsn values as string 2024-11-05 09:39:04 +05:30
fixtures fix: add suriname currency and locale 2023-09-07 09:31:37 +05:30
fyo feat: toggler removed from sidebar and added a field to enable dark mode in Settings > System > Theme 2024-08-20 18:17:46 +05:30
main fix: convert camelCase to kebab-case, resolve lint warnings 2024-09-25 09:40:04 +05:30
models feat: validate hsnCode 2024-11-04 12:49:07 +05:30
regional incr: display gstr reports 2022-05-23 16:18:23 +05:30
reports fix(reports): Allow multiple root account to have the same type 2023-12-05 21:38:25 +01:00
schemas fix: fieldType of hsncode 2024-11-04 12:33:44 +05:30
scripts fix: use knex for checking values 😔 2023-07-13 11:12:43 +05:30
src fix: renamed newLink to secondaryLink 2024-10-29 11:02:16 +05:30
templates feat: add option to enable/disable amount in words in print settings 2024-10-10 16:18:41 +05:30
tests chore: set hsn values as string 2024-11-05 09:39:04 +05:30
translations chore: added some german translations 2024-11-01 16:44:28 +01:00
uitest fix(ux): remove file selection on create 2023-07-11 13:43:32 +05:30
utils feat: Added custom titleBarverlay with close,minimize and maximize styles 2024-08-20 11:56:01 +05:30
.eslintrc.js Fixed formatting 2024-01-24 19:11:31 -08:00
.git-blame-ignore-revs chore: blame ignore formatting changes 2023-06-27 13:11:54 +05:30
.gitignore Add regional schemas for Switzerland. 2023-11-28 22:14:35 +01:00
.prettierignore Changed how datetime was fixed for various timezones 2024-02-01 15:54:46 -08:00
colors.json feat: windowstitlebar, sidebar and Dashboard changed to darkmode 2024-08-20 11:55:59 +05:30
electron-builder-config.mjs Fixed linting for PR 843 2024-02-11 16:09:35 -08:00
electron-builder.yml.disabled Updating electron-builder to a ts file 2024-01-24 19:03:04 -08:00
LICENSE chore: Change license to AGPLv3 2020-01-02 23:58:53 +05:30
main.ts feat: Added custom titleBarverlay with close,minimize and maximize styles 2024-08-20 11:56:01 +05:30
META.md incr: add GeneralLedger business logic 2022-05-23 16:18:23 +05:30
package.json chore: v0.24.0 2024-10-29 15:06:56 +05:30
postcss.config.js chore: format files using prettier 2023-06-27 13:11:15 +05:30
README.md docs: updated german translation contributors 2024-11-04 10:18:39 +05:30
tailwind.config.js fix: format using prettier 2024-08-20 13:11:33 +05:30
tsconfig.json chore: bump lint dependencies 2023-06-21 13:35:42 +05:30
vite.config.ts chore: format files using prettier 2023-06-27 13:11:15 +05:30
yarn.lock Merge pull request #960 from frappe/dependabot/npm_and_yarn/micromatch-4.0.8 2024-10-29 09:53:51 +05:30

Frappe Books logo

GitHub release (latest by date) Platforms Publish

Free Desktop book-keeping software for small businesses and freelancers.

frappe.io/books

Frappe Books Preview

Index

[show/hide]
  1. Features
  2. Installation
  3. Development
  4. Contributions and Community
  5. Links
  6. Translation Contributors
  7. License

Features

  1. Double-entry accounting
  2. Point of Sale
  3. Invoicing
  4. Billing
  5. Payments
  6. Journal Entries
  7. Dashboard
  8. Works Offline
  9. Financial Reports
    • General Ledger
    • Profit and Loss Statement
    • Balance Sheet
    • Trial Balance

Installation

Via Flatpak

Get it on Flathub

Using Homebrew (for MacOS and Linux)

brew install --cask frappe-books

Manual

Download and install the latest release for your platform from the releases page .

Development

Frappe Books is built on Vue.js and Electron. It is offline by default and uses a local SQLite file as the database.

Pre-requisites

To get the dev environment up and running you need to first set up Node.js version 16.14.0 and npm. For this, we suggest using nvm.

Next, you will need to install yarn.

Clone and Run

Once you are through the Pre-requisites, you can run the following commands to setup Frappe Books for development and building:

# clone the repository
git clone https://github.com/frappe/books.git

# change directory
cd books

# install dependencies
yarn

Development

To run Frappe Books in development mode (with hot reload, etc):

# start the electron app
yarn dev

Note: First Boot

When you run yarn dev electron will run immediately but the UI will take a couple of seconds to render this because of how dev mode works. Each file is individually served by the dev server. And there are many files that have to be sent.

Note: Debug Electron Main Process

When in dev mode electron runs with the --inspect flag which allows an external debugger to connect to port 5858. You can use chrome for this by visiting chrome://inspect while Frappe Books is running in dev mode.

See more here.

Build

To build Frappe Books and create an installer:

# start the electron app
yarn build

Note: Build Target By default the above command will build for your computer's operating system and architecture. To build for other environments (example: for linux from a windows computer) check the Building section at electron.build/cli.

So to build for linux you could use the --linux flag like so: yarn build --linux.

Contributions and Community

If you want to contribute to Frappe Books, please check our Contribution Guidelines. There are many ways you can contribute even if you don't code:

  1. If you find any issues, no matter how small (even typos), you can raise an issue to inform us.
  2. You can help us with language support by contributing translations.
  3. You can join our telegram group and share your thoughts.
  4. If you're an ardent user you can tell us what you would like to see.
  5. If you have accounting requirements, you can become an ardent user. 🙂

If you want to contribute code then you can fork this repo, make changes and raise a PR. (see how to)

  • Telegram Group: Used for discussions and decisions regarding everything Frappe Books.
  • GitHub Discussions: Used for discussions around a specific topic.
  • Frappe Books Blog: Sporadically updated dev blog regarding the development of this project.

Translation Contributors

Language Contributors
French DeepL, mael-chouteau, joandreux
German DeepL, barredterra, promexio, C2H6-383, 0xflotus
Portuguese DeepL, Valdir Amaral
Arabic taha2002, Faridget
Catalan Dídac E. Jiménez
Dutch RijckAlex
Spanish talmax1124, delbertf
Gujarati dhruvilxcode, 4silvertooth
Hindi bnsinghgit
Korean Isaac-Kwon
Simplified Chinese wcxu21, wolone, Ji Qu
Swedish papplo, Crims-on
Turkish Eyuq, XTechnology-TR
Danish Tummas Joensen

License

GNU Affero General Public License v3.0