Skip to content

builder555/bil

Repository files navigation

Budget Insight Ledger

^ This is the best title GPT could spit out. A very basic bookkeeping/finance tracker for personal (or small business) use. It can run standalone or in a docker container. Stores database in json files, each project is a git repo, allowing you to undo any action and view the state of your project at any point in the past.

The app does not collect any personal information

Features

  • grouping transactions
  • search-as-you-type for groups and individual payments
  • mobile-friendly
  • receipt attachments
  • friendly API (swagger)
  • view of past states

Wishlist

  • read-only mode when viewing past states
  • passcode authentication
  • calendar view for date inputs
  • migrations for database changes preserving rollback

Run

docker run -v ./data:/app/data -p 8000:8000 builder555/bil

Navigate to http://localhost:8000

Development

Prerequisites:

  • node 16+
  • yarn
  • python 3.10+
  • poetry
  • libmagic
  • setuptools
git clone https://github.com/builder555/bil.git

# run api:
cd bil/api
poetry install
poetry run start
# to view swagger: http://localhost:8000/docs

#run ui:
cd bil/ui
yarn install
yarn run serve
#to view ui: http://localhost:8080
image

screencap