Zebabu
Personal budget manager built with SvelteKit, PostgreSQL, and Drizzle ORM - track income, expenses, and transactions across multiple budgets.
Zebabu
A personal budget management web app for tracking income, expenses, and transactions across multiple budgets.
Features
- Email/password authentication with email verification and password reset
- Create, duplicate, and delete budgets (monthly or scenario type)
- Categorize income and expenses per budget
- Track transactions within categories
- Drag-and-drop category and transaction reordering
- Multi-language support
Tech Stack
| Layer | Technology |
|---|---|
| Framework | SvelteKit 2 + Svelte 5 |
| Language | TypeScript 5 (strict) |
| Styling | Tailwind CSS v4 |
| UI Components | shadcn-svelte (bits-ui) |
| Forms | sveltekit-superforms + Zod v4 |
| i18n | Paraglide (inlang) |
| Auth | better-auth |
| Database | PostgreSQL 18 + Drizzle ORM |
| Sessions | Redis 8 |
| Resend + React Email | |
| Build | Vite 7 + Turbo (monorepo) |
| Package Manager | bun |
Getting Started
Prerequisites: Node.js v24+, Bun v1+, Docker
1. Install dependencies
bun install
2. Configure environment variables
cp .env.example .env
cp apps/web/.env.example apps/web/.env
Root .env:
POSTGRES_USER=your_username
POSTGRES_PASSWORD=your_password
POSTGRES_DB=your_database
apps/web/.env:
DATABASE_URL="postgres://your_username:your_password@localhost:5432/your_database"
BETTER_AUTH_SECRET="your-secret-string"
BETTER_AUTH_BASE_URL="http://localhost:3000"
REDIS_URL="redis://localhost:6379"
APP_URL="http://localhost:3000"
RESEND_API_KEY="re_your_api_key"
EMAIL_FROM="Zebabu <[email protected]>"
3. Start local services
bun run db:start # starts PostgreSQL + Redis via Docker
4. Run database migrations
bun run db:migrate
5. Start dev server
bun run dev # web app at http://localhost:3000
Commands
| Command | Description |
|---|---|
bun run dev |
Start development server |
bun run build |
Production build |
bun run lint |
ESLint |
bun run format |
Prettier |
bun run check |
TypeScript type check |
bun run test |
Run tests |
bun run db:start |
Start Docker services |
bun run db:migrate |
Run database migrations |
bun run db:studio |
Open Drizzle Studio |
bun run redis:studio |
Open Redis Commander |
