books

mirror of https://github.com/frappe/books.git synced 2024-12-23 11:29:03 +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 1d0db3579a fix(ui): empty state svg alignment		2021-12-07 11:18:56 +05:30
.github	fix: update all icons, fix notarize import, update README.md	2021-11-23 12:56:46 +05:30
.vscode	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
accounting	fix: ES6 dynamic import on importing fixture JSONs	2021-11-12 00:31:30 +05:30
build	build: mention team id for notarization	2021-12-06 16:36:26 +05:30
fixtures	fix: bank account parent not being set on setup	2021-11-10 14:29:25 +05:30
models	fix: make onboarding completable	2021-12-02 18:41:56 +05:30
patches	refactor: update patch run pre and post migration patches	2021-11-30 17:39:40 +05:30
public	feat: Rename to Frappe Books	2020-01-02 23:09:58 +05:30
reports	Add ability to cancel invoice	2021-11-21 19:08:04 +05:30
server	build(electron): bump electron to 15.3.0	2021-11-05 14:31:35 +05:30
src	fix(ui): empty state svg alignment	2021-12-07 11:18:56 +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
.travis.yml	fix: Remove font manager until we find alternative	2020-02-10 13:25:26 +05:30
babel.config.js	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
electron-builder.yml	fix linux icons not showing and add deb and rpm package	2021-11-23 18:34:50 +05:30
LICENSE	chore: Change license to AGPLv3	2020-01-02 23:58:53 +05:30
package.json	chore: remove browserlist cause serve errors, will add it in later if the need arises	2021-12-06 16:44:27 +05:30
postcss.config.js	chore: Migrate project structure to Vue CLI	2019-12-12 23:07:43 +05:30
README.md	fix: update all icons, fix notarize import, update README.md	2021-11-23 12:56:46 +05:30
tailwind.config.js	chore: bump tailwind to 2, postcss 7 compat mode	2021-11-02 18:00:45 +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	build(electron): bump electron to 15.3.0	2021-11-05 14:31:35 +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