books

mirror of https://github.com/frappe/books.git synced 2024-11-08 23:00:56 +00:00

Free desktop accounting software for small-businesses and freelancers.

accounting book-keeping desktop double-entry-accounting electron frappe javascript offline open-source vuejs

Go to file

18alantom 8f5d71f743 fix: refactor donutchart - factor in edge cases - z-index on dropdown		2022-01-18 12:12:37 +05:30
.github	ci(publish:win): fix tar line in a noob way	2022-01-14 17:42:15 +05:30
.vscode	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
accounting	fix: use pesa in gst reports when using raw knex	2022-01-17 17:37:22 +05:30
build	build(macOS): add flag for notarization	2021-12-13 15:00:59 +05:30
fixtures	chore: deprecate numberFormat	2022-01-07 10:51:19 +05:30
models	fix(ux): allow custom empty messages in autocomp	2022-01-12 15:04:16 +05:30
patches	fix: breaking of patch due to deprecated field numberFormat	2022-01-07 11:42:21 +05:30
public	feat: Rename to Frappe Books	2020-01-02 23:09:58 +05:30
reports	Merge pull request #305 from piyushsinghania/fix/profit-loss-report-filter-fields	2022-01-14 13:02:10 +05:30
server	build(electron): bump electron to 15.3.0	2021-11-05 14:31:35 +05:30
src	fix: refactor donutchart	2022-01-18 12:12:37 +05:30
tests	build(electron): bump electron to 15.3.0	2021-11-05 14:31:35 +05:30
.eslintrc.js	Add ability to cancel invoice	2021-11-21 19:08:04 +05:30
.gitignore	fix: update all icons, fix notarize import, update README.md	2021-11-23 12:56:46 +05:30
babel.config.js	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
electron-builder.yml	build(win): fix webkit-app-region issue	2021-12-07 18:41:58 +05:30
LICENSE	chore: Change license to AGPLv3	2020-01-02 23:58:53 +05:30
package.json	chore(deps-dev): bump postcss from 7.0.39 to 8.2.13	2022-01-14 11:57:14 +05:30
postcss.config.js	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
README.md	fix: unmatched div tag	2021-12-08 19:18:20 +05:30
tailwind.config.js	fix(ui): use inline validations	2022-01-10 13:47:23 +05:30
vue.config.js	refactor: deprecate use of remote; remove bg transparency on macOS	2021-11-04 15:03:51 +05:30
yarn.lock	chore(deps): bump engine.io from 6.1.0 to 6.1.1	2022-01-14 13:23:57 +05:30

README.md

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

Features

Double-entry accounting
Invoicing
Billing
Payments
Journal Entries
Dashboard
Works Offline
Financial Reports
- General Ledger
- Profit and Loss Statement
- Balance Sheet
- Trial Balance
Multi-currency Invoicing

Download

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

Development

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

Pre-requisites

Install build essentials

Ubuntu

apt-get install build-essential python git
apt-get install libgconf-2-4

MacOS

xcode-select --install

You will also need Xcode App from App Store

Install Node.js. Check the package.json file for the node version.

Tip: The best way to install and manage Node is to install nvm
Install yarn package manager
```
npm install -g yarn
```

Clone and Run

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

# change directory
cd books

# install dependencies
yarn

# start the electron app
yarn electron:serve

Developing with FrappeJS

FrappeBooks is based on FrappeJS for managing models and objects. To develop alongside FrappeJS

# clone frappejs
git clone https://github.com/frappe/frappejs.git

# link frappejs
cd frappejs
yarn link

Then in the Frappe books folder.

yarn link frappejs

FAQ

Launching electron and nothing displays https://github.com/nklayman/vue-cli-plugin-electron-builder/issues/24#issuecomment-770165389

sudo chown root node_modules/electron/dist/chrome-sandbox && sudo chmod 4755 node_modules/electron/dist/chrome-sandbox

License

GNU Affero General Public License v3.0