Skip to content

builder555/bil

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b01ff37 · Nov 29, 2024
Nov 10, 2024
Nov 29, 2024
Nov 27, 2024
Oct 10, 2024
Jun 27, 2024
Oct 10, 2024
Nov 27, 2024
Oct 3, 2024
Oct 2, 2024
Oct 20, 2024

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
  • read-only mode when viewing past states

Wishlist

  • upgrade to vue3
  • add tags and by-tag filtering
  • passcode authentication
  • calendar view for date inputs
  • migrations for database changes preserving rollback
  • CSV group export

Run

Directly from command line

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

Navigate to http://localhost:8000

Or using docker-compose

Create a compose.yml file:

services:
  main:
    image: builder555/bil:latest
    container_name: bil
    volumes:
      - ./data:/app/data
    ports:
      - "8000:8000"
    restart: unless-stopped

Start:

docker compose up -d

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