frappe / books Goto Github PK

Free Accounting Software

License: GNU Affero General Public License v3.0

JavaScript 1.22% HTML 0.93% CSS 0.22% Vue 36.36% TypeScript 61.14% Shell 0.14%

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

books's Introduction

Important

Frappe Books is looking for a maintainer, please view #775 for more info.

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

frappebooks.com

Index

[show/hide]

Features
Installation
Development
Contributions and Community
Links
Translation Contributors
License

Features

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

Installation

Download and install the latest release for your platform from the releases page or the download 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:

If you find any issues, no matter how small (even typos), you can raise an issue to inform us.
You can help us with language support by contributing translations.
You can join our telegram group and share your thoughts.
If you're an ardent user you can tell us what you would like to see.
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)

Translation Contributors

Language	Contributors
French	DeepL, mael-chouteau, joandreux
German	DeepL, barredterra, promexio, C2H6-383
Portuguese	DeepL
Arabic	taha2002, Faridget
Catalan	Dídac E. Jiménez
Dutch	FastAct
Spanish	talmax1124, delbertf
Gujarati	dhruvilxcode, 4silvertooth
Korean	Isaac-Kwon
Simplified Chinese	wcxu21, wolone
Swedish	papplo
Turkish	Eyuq, XTechnology-TR

License

GNU Affero General Public License v3.0

books's People

Contributors

Stargazers

Watchers

Forkers

achillesrasquinha shridarpatil revant rmehta netchampfaris surajshetty3416 ibnuhelmi jaffreyjoy nurdtechie98 karan28598 email-frappejs haquezameer sayantikabanik anto-christo deatram yashodhank krishamehta ernestofosu05 sahil28297 yefritavarez ketansdesai nagarajannxweb stevenpegas lelsheri nextchamp-saqib lmm713281 trenddev salvatoretrimarchi prssanna gokul0625 ayushgupta6598 mrmoyeez tanawutwatthana jabulanidavid diacu seehive sturtuk ch0nch0l connectdtk 5-digits hhy5277 franklin0702 cgarg arifahs kyleparisi gmkr jayanti-prajapati jarveypaulo oxynet1 nirajkvinit ninja243 ruo2012 ooquincyoo zahedbri chaampavictor grandpiano asoral jigartarpara showchiranjit databill86 jane-alam kumarsh8483 onlyshishir snawar92 supriyoa nzahmed erp-next-me sshyran sigmamupi sivaranjanipalanivel netmanthan aliabed982 ideatip-holder mobile4g krolnoeurn rizwanbinzahir sysidos askmetoo donell206 lesliesibbs cuulee regniraj sss-software amanjiofficial paulfanen shepherdscribe jsbrain elba7r afshankhan klezmania devil1991 dehboris nightlyworker factsfinder ragnardanneskjold rebootcode mindkhichdi sadiqmmm viraj99 conradakunga

books's Issues

Failing Yarn Install

Step 1: Clone Project
Step 2: yarn install

➜  accounting git:(master) yarn install
yarn install v1.5.1
(node:8727) [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead.
[1/4] 🔍  Resolving packages...
[2/4] 🚚  Fetching packages...
error [email protected]: The engine "node" is incompatible with this module. Expected version "8.11.1".
error An unexpected error occurred: "Found incompatible module".
info If you think this is a bug, please open a bug report with the information provided in "/Users/dominik/Dev/accounting/yarn-error.log".
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

[UI] Ability to see list of payments

No wizard after installation of Beta 0.0.2 on Windows

Good day!

I downloaded a Windows installer from here and ran it. After the installation the app window opens, but it is blank, no wizard is starting up. I do not see a way to start a wizard from the menu either. Am I missing something?

Models

[move-to-vue] : Could not resolve './config' from accounting/setup/index.js

Shouldn't the path be '../src/pages/SetupWizard/config' @netchampfaris @surajshetty3416

After submitting an invoice, follow links do not appear

Print Formats

Clicking on an item in the list panel does not show the item details

When you click on a list item in the central panel, it is expected to see its details in the main details section. However, this is not the case when you click on top of the text, it requires clicking a bit to the right outside the text. It happens for all sections party, invoice, item, etc

Using Chrome Version 67.0.3396.99 (Official Build) (64-bit) on Ubuntu

Payment

Item selection in invoice (dropdown is hidden)

User Manual

fix date format (for india)

Add nvmrc?

Should we add a .nvmrc to checkout to 8.11.1 when using this project? How are you guys handling node version change when using this project?
@rmehta @netchampfaris

[Bug] Creation of a customer does not set "is customer" by default in Party

Language

Default account in party

rtl support

Hi
What about supporting Rtl cultures?

Reports

Trial Balance

Ability to see journal entries

After install on mac unable to open application

“Frappe Accounting” can’t be opened because it is from an unidentified developer.

Your security preferences allow installation of only apps from the App Store and identified developers.

“Frappe Accounting” is on the disk image “Frappe.Accounting-0.0.2.dmg”. Chrome downloaded this disk image today at 11:04 AM from github.com.

Payment entry option for managing payment records

We need Payment entry option for managing payment records and default account heads must be assigned based on the payment record.

Warn in case of overpayment

Add field Outstanding Amount in Invoice (should be calculated from Ledger)
Every time a payment is made, recalculate outstanding
Validate outstanding is not negative

Can't change item rate

Unable to modify item rate

Country Defaults

Chart of accounts
Date and time
Currency

When running yarn dev webpack can't find some dependencies

Hey,

I was trying to run this in my local, but after installing node version 8.11.1 and doing yarn --pure-lockfile I got this error when trying to start yarn dev

These dependencies were not found:

$ webpack-dev-server --inline --progress --config build/webpack.dev.conf.js
94% asset optimization

ERROR Failed to compile with 44 errors

feather-icons in ./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/selector.js?type=script&index=0!./node_modules/frappejs/ui/components/controls/Link.vue
frappe-datatable in ./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/selector.js?type=script&index=0!./node_modules/frappejs/ui/components/ModelTable.vue, ./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/selector.js?type=script&index=0!./node_modules/frappejs/ui/pages/Report/index.vue
frappejs/ui/constants/indicators in ./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/selector.js?type=script&index=0!./src/pages/SetupWizard/index.vue
frappejs/ui/plugins/frappeVue in ./src/main.js
vue in ./node_modules/frappejs/ui/components/ModelTable.vue, ./node_modules/frappejs/ui/components/Desk.vue and 35 others
vue-flatpickr-component in ./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/selector.js?type=script&index=0!./node_modules/frappejs/ui/components/controls/Date.vue
vue-router in ./src/router/index.js

To install them, you can run: npm install --save feather-icons frappe-datatable frappejs/ui/constants/indicators frappejs/ui/plugins/frappeVue vue vue-flatpickr-component vue-router

Tried to install those dependencies but failed.

nf start

fs.js:646
return binding.open(pathModule._makeLong(path), stringToFlags(flags), mode);
^

Error: ENOENT: no such file or directory, open 'start'
at Object.fs.openSync (fs.js:646:18)
at Object.fs.readFileSync (fs.js:551:33)
at Object. (/home/vishal/.nvm/versions/node/v8.9.4/lib/node_modules/nf/nf.js:73:15)
at Module._compile (module.js:643:30)
at Object.Module._extensions..js (module.js:654:10)
at Module.load (module.js:556:32)
at tryModuleLoad (module.js:499:12)
at Function.Module._load (module.js:491:3)
at Function.Module.runMain (module.js:684:10)
at startup (bootstrap_node.js:187:16)

Sales and Purchase Ledger

Bill

Electronify

File Open
File Save
Build Script
Entry Point

unable to successfully perform ` yarn install `

Tried to perform `yarn install` but got the following error :

Complete error log :

Error: C:\Program Files\nodejs\node.exe exited with code 1
Error output:
node-pre-gyp info it worked if it ends with ok
node-pre-gyp info using [email protected]
node-pre-gyp info using [email protected] | win32 | x64
node-pre-gyp http GET https://mapbox-node-binary.s3.amazonaws.com/sqlite3/v3.1.13/electron-v1.8-win32-x64.tar.gz
node-pre-gyp http 403 https://mapbox-node-binary.s3.amazonaws.com/sqlite3/v3.1.13/electron-v1.8-win32-x64.tar.gz
node-pre-gyp ERR! Tried to download(403): https://mapbox-node-binary.s3.amazonaws.com/sqlite3/v3.1.13/electron-v1.8-win32-x64.tar.gz
node-pre-gyp ERR! Pre-built binaries not found for [email protected] and [email protected] (electron-v1.8 ABI, unknown) (falling back to source compile with node-gyp)
node-pre-gyp http 403 status code downloading tarball https://mapbox-node-binary.s3.amazonaws.com/sqlite3/v3.1.13/electron-v1.8-win32-x64.tar.gz
gyp info it worked if it ends with ok
gyp info using [email protected]
gyp info using [email protected] | win32 | x64
gyp info ok
gyp info it worked if it ends with ok
gyp info using [email protected]
gyp info using [email protected] | win32 | x64
gyp ERR! configure error
gyp ERR! stack Error: Can't find Python executable "C:\Users\Jaffrey Joy\AppData\Local\Programs\Python\Python36\python.EXE", you can set the PYTHON env variable.
gyp ERR! stack     at PythonFinder.failNoPython (C:\nvm\v8.9.4\node_modules\npm\node_modules\node-gyp\lib\configure.js:483:19)
gyp ERR! stack     at PythonFinder.<anonymous> (C:\nvm\v8.9.4\node_modules\npm\node_modules\node-gyp\lib\configure.js:508:16)
gyp ERR! stack     at C:\nvm\v8.9.4\node_modules\npm\node_modules\graceful-fs\polyfills.js:284:29
gyp ERR! stack     at FSReqWrap.oncomplete (fs.js:152:21)
gyp ERR! System Windows_NT 10.0.16299
gyp ERR! command "C:\\Program Files\\nodejs\\node.exe" "C:\\Program Files\\nodejs\\node_modules\\npm\\node_modules\\node-gyp\\bin\\node-gyp.js" "configure" "--fallback-to-build" "--module=H:\\GitHub clones\\accounting\\node_modules\\sqlite3\\lib\\binding\\electron-v1.8-win32-x64\\node_sqlite3.node" "--module_name=node_sqlite3" "--module_path=H:\\GitHub clones\\accounting\\node_modules\\sqlite3\\lib\\binding\\electron-v1.8-win32-x64"
gyp ERR! cwd H:\GitHub clones\accounting\node_modules\sqlite3
gyp ERR! node -v v8.9.4
gyp ERR! node-gyp -v v3.6.2
gyp ERR! not ok
node-pre-gyp ERR! build error
node-pre-gyp ERR! stack Error: Failed to execute 'node-gyp.cmd configure --fallback-to-build --module=H:\GitHub clones\accounting\node_modules\sqlite3\lib\binding\electron-v1.8-win32-x64\node_sqlite3.node --module_name=node_sqlite3 --module_path=H:\GitHub clones\accounting\node_modules\sqlite3\lib\binding\electron-v1.8-win32-x64' (1)
node-pre-gyp ERR! stack     at ChildProcess.<anonymous> (H:\GitHub clones\accounting\node_modules\node-pre-gyp\lib\util\compile.js:83:29)
node-pre-gyp ERR! stack     at emitTwo (events.js:126:13)
node-pre-gyp ERR! stack     at ChildProcess.emit (events.js:214:7)
node-pre-gyp ERR! stack     at maybeClose (internal/child_process.js:925:16)
node-pre-gyp ERR! stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:209:5)
node-pre-gyp ERR! System Windows_NT 10.0.16299
node-pre-gyp ERR! command "C:\\Program Files\\nodejs\\node.exe" "H:\\GitHub clones\\accounting\\node_modules\\node-pre-gyp\\bin\\node-pre-gyp" "install" "--fallback-to-build"
node-pre-gyp ERR! cwd H:\GitHub clones\accounting\node_modules\sqlite3
node-pre-gyp ERR! node -v v8.9.4
node-pre-gyp ERR! node-pre-gyp -v v0.6.39
node-pre-gyp ERR! not ok
error An unexpected error occurred: "Command failed.
Exit code: 1
Command: C:\\WINDOWS\\system32\\cmd.exe
Arguments: /d /s /c node-pre-gyp install --fallback-to-build
Directory: H:\\GitHub clones\\accounting\
ode_modules\\sqlite3
Output:
".

    at ChildProcess.childProcess.once.code (H:\GitHub clones\accounting\node_modules\electron-builder-lib\node_modules\builder-util\src\util.ts:251:14)
    at Object.onceWrapper (events.js:317:30)
    at emitTwo (events.js:126:13)
    at ChildProcess.emit (events.js:214:7)
    at maybeClose (internal/child_process.js:925:16)
    at Socket.stream.socket.on (internal/child_process.js:346:11)
    at emitOne (events.js:116:13)
    at Socket.emit (events.js:211:7)
    at Pipe._handle.close [as _onclose] (net.js:554:12)
From previous event:
    at runCallback (timers.js:789:20)
    at tryOnImmediate (timers.js:751:5)
    at processImmediate [as _immediateCallback] (timers.js:722:5)
From previous event:
    at H:\GitHub clones\accounting\node_modules\electron-builder-lib\src\util\yarn.ts:149:27
From previous event:
    at rebuild (H:\GitHub clones\accounting\node_modules\electron-builder-lib\out\util\yarn.js:233:18)
    at H:\GitHub clones\accounting\node_modules\electron-builder-lib\src\util\yarn.ts:20:11
From previous event:
    at installOrRebuild (H:\GitHub clones\accounting\node_modules\electron-builder-lib\out\util\yarn.js:68:17)
    at H:\GitHub clones\accounting\node_modules\electron-builder\src\cli\install-app-deps.ts:57:5
    at Generator.next (<anonymous>)
From previous event:
    at installAppDeps (H:\GitHub clones\accounting\node_modules\electron-builder\out\cli\install-app-deps.js:174:17)
    at then (H:\GitHub clones\accounting\node_modules\electron-builder\src\cli\cli.ts:43:10)
    at runCallback (timers.js:789:20)
    at tryOnImmediate (timers.js:751:5)
    at processImmediate [as _immediateCallback] (timers.js:722:5)
From previous event:
    at Object.args [as handler] (H:\GitHub clones\accounting\node_modules\electron-builder\src\cli\cli.ts:43:10)
    at Object.runCommand (H:\GitHub clones\accounting\node_modules\yargs\lib\command.js:235:44)
    at Object.parseArgs [as _parseArgs] (H:\GitHub clones\accounting\node_modules\yargs\yargs.js:1014:30)
    at Object.get [as argv] (H:\GitHub clones\accounting\node_modules\yargs\yargs.js:957:21)
    at Object.<anonymous> (H:\GitHub clones\accounting\node_modules\electron-builder\src\cli\cli.ts:28:22)
    at Module._compile (module.js:643:30)
    at Object.Module._extensions..js (module.js:654:10)
    at Module.load (module.js:556:32)
    at tryModuleLoad (module.js:499:12)
    at Function.Module._load (module.js:491:3)
    at Function.Module.runMain (module.js:684:10)
    at startup (bootstrap_node.js:187:16)
    at bootstrap_node.js:608:3
error An unexpected error occurred: "Command failed.
Exit code: 1
Command: C:\\WINDOWS\\system32\\cmd.exe
Arguments: /d /s /c electron-builder install-app-deps
Directory: H:\\GitHub clones\\accounting
Output:
".
info If you think this is a bug, please open a bug report with the information provided in "H:\\GitHub clones\\accounting\\yarn-error.log".
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

Steps to reproduce :

node 8.9.6
yarn 1.5.1
python 3.6.5
changed "../frappe" in dependencies in package.json to "0.0.5" i.e. the frappejs npm package version i found in the npm site

Import COA

I got an Import InportCOA error while running yarn .
Turns out that server/registerServerMethods.js line no. 11, needs to be changed from "A" to "a":

`const importCOA = require('../models/doctype/account/importCOA');`

Review / merge existing PRs
Build and upload
Update docs / screenshots for Beta 2

Sales Trend
Expense Trend
Bank Balance

frappe / books Goto Github PK

books's Introduction

Index

Features

Installation

Development

Pre-requisites

Clone and Run

Development

Build

Contributions and Community

Links

Translation Contributors

License

books's People

Contributors

Stargazers

Watchers

Forkers

books's Issues

Tried to perform yarn install but got the following error :

Complete error log :

Steps to reproduce :

Recommend Projects

Recommend Topics

Recommend Org

Tried to perform `yarn install` but got the following error :