Align

Personal finance app I built to run our household money. Self-hosted, so the data lives in a database you own. Comes with a web app and an Android app that share one backend.

Runs on the free tiers of Vercel and Neon, so hosting it costs nothing. Nobody sees your numbers but you.

What it does

The core is a zero-based budget: income comes in, you assign all of it, and money can't leave a bucket without saying where it came from. Around that there's:

• Expenses and income with categories, tags, and recurring entries
• Savings pots in PKR and USD (emergency, liquid, general), with deposits that have to declare a source
• Goals, investments, and loans (settling a loan logs the expense for you, with repayment schedules and a forward cash-flow projection)
• Tasks (daily habits, one-offs, and checklists) and a Projects board for freelance/client work
• A planner for big life events, a calendar, and want/need lists
• A private gift planner that only the super admin can see

The exchange rate between PKR and USD syncs once a day. There are two roles: super admin (everything) and admin (everything except the vault and user management).

How it's laid out

align/
  apps/
    web/      Next.js + Prisma + Postgres. The app, plus the REST API.
    mobile/   Flutter Android client. Talks to /api/v1.
  docs/
  .github/    CI, split so web changes don't run the Flutter build.

The web app owns the database and exposes the API the phone app uses. If you only want the web app, you never have to touch the mobile side.

Running the web app

You need a free Postgres database. A Neon branch is the easiest.

cd apps/web
cp .env.example .env.local     # fill in your database URL and secrets
pnpm install
pnpm exec prisma migrate dev   # creates the tables
pnpm seed                      # creates your login(s)
pnpm dev                       # http://localhost:3000

Longer version in apps/web/README.md. Deploying to Vercel is in apps/web/DEPLOYMENT.md.

Want to call it something other than "Align"? Set NEXT_PUBLIC_APP_NAME and it changes everywhere in the UI.

Or with Docker

Brings up Postgres and the web app together — no local Node or Postgres needed:

cp .env.docker.example .env    # then set the three secrets it lists
docker compose up --build      # http://localhost:3000

The database starts first, migrations run automatically, and (with SEED_ON_START=true) a first admin user is created from the USER1_* values in your .env. Postgres is exposed on localhost:5434 if you want to poke at it.

Running the mobile app

cd apps/mobile
flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter run --dart-define=API_BASE_URL=https://your-server.example.com/api/v1

More in apps/mobile/README.md. Pass --dart-define=APP_NAME=YourName to rename it there too.

Stack

Web is Next.js 16, React 19, Prisma 7, Postgres, NextAuth v5, and Tailwind v4. Mobile is Flutter with Riverpod, GoRouter, and Dio, laid out in clean-architecture slices. Both host on free tiers.

More docs

• ARCHITECTURE.md covers how the money rules work. Read it before you touch anything financial.
• CONTRIBUTING.md has the dev setup and the house rules.
• SECURITY.md is how to report something sensitive.

License

MIT. See LICENSE.