explaingit

cyber-dioxide/gigledger

17HTMLAudience · pm founderComplexity · 2/5Setup · moderate

TLDR

A self-hosted finance dashboard for freelancers that shows how much of your bank balance is safe to spend after taxes, tracks invoices and projects, and calculates how many months your cash covers your expenses.

Mindmap

mindmap
  root((gigledger))
    What it does
      Safe to Spend figure
      Tax obligation tracking
      Cash runway calculator
    Features
      Invoice management
      Project hour logging
      Client records
      PDF and CSV export
    Dashboard views
      Income and expenses
      Savings goals
      Recurring costs
    Tech stack
      Python
      Flask
      Local database
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

See exactly how much of your freelance balance you can safely spend after your quarterly tax reserve is subtracted.

USE CASE 2

Create invoices that automatically split payments into a spendable amount and a tax reserve when marked paid.

USE CASE 3

Track hours against client projects at hourly or fixed rates and see total invoiced versus outstanding per client.

USE CASE 4

Calculate how many months your current balance covers your expenses, color-coded green, yellow, or red.

Tech stack

PythonFlaskHTMLCSSSQLite

Getting it running

Difficulty · moderate Time to first run · 30min

Runs on Python and Flask with a local database, ships with a demo account pre-loaded with six months of realistic data to explore before entering real numbers.

In plain English

GigLedger is a finance dashboard you run on your own computer or server, built specifically for freelancers, contractors, and gig workers. The core idea is that typical personal finance apps don't account for the tax complexity of self-employment, while full accounting software is more than most solo workers need. GigLedger sits in the middle, giving you clear answers to three questions freelancers care about most: how much of your balance is actually safe to spend after setting aside taxes, what you owe this quarter, and how many months your current balance can cover your expenses. The dashboard pulls together income, expenses, invoices, client records, project tracking, savings goals, and recurring costs into one screen. A Safe to Spend figure subtracts your running tax obligation from your bank balance so you don't accidentally spend money that belongs to the government. A runway calculator divides your balance by your average monthly expenses over the last three months and color-codes the result: green for six or more months, yellow for three to six, red for under three. Invoicing is tightly connected to the financial picture. When you mark an invoice as paid, GigLedger automatically creates two transactions: one for the income and one that sets aside the tax portion as a reserve. Your tax obligation updates in real time without manual entries. You can also generate PDF invoices and export filtered transaction reports to CSV or PDF. Project and client management are included. You can log hours against projects, set hourly or fixed rates, and track deadlines. Client records store contact details and show totals for invoiced, paid, and outstanding amounts across all linked invoices. The app runs on Python and Flask, stores data in a local database, and supports multiple currencies and five color themes including a dark mode. It ships with a demo account pre-loaded with six months of realistic data so you can explore how everything works before entering your own numbers.

Copy-paste prompts

Prompt 1
I just started freelancing. Set up GigLedger, configure my tax rate, and walk me through entering my first invoice so the tax reserve calculates automatically.
Prompt 2
I want to see my GigLedger cash runway. Explain how it calculates months of runway from my current balance and the last three months of expenses.
Prompt 3
Generate a PDF invoice in GigLedger for a client, mark it paid, and show me how the automatic tax reserve transaction is created.
Prompt 4
I'm a freelancer in a country with a different currency. Walk me through changing GigLedger's currency setting and entering expenses in that currency.
Open on GitHub → Explain another repo

← cyber-dioxide on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.