A beautiful budgeting app that helps you grow your finances. Built with Next.js 14, Prisma, Lucia Auth, and AI-powered assistance.

• 🤖 AI-Powered Assistant - Meet Bud, your personal gardener! Chat naturally to add transactions, create accounts, transfer funds, and more
• 🔐 Secure Authentication - Sign up and sign in with Lucia session-based auth
• 💰 Multiple Accounts - Track savings, budgets, allowances, retirement, and stock accounts
• 📊 Transaction Tracking - Record income and expenses with automatic balance updates
• 🔄 Easy Transfers - Move money between accounts with one click
• 👥 Dashboard Sharing - Invite family or partners to view and collaborate on your finances
• ⚡ Quick Actions - Add transactions, transfers, and accounts from a convenient modal interface
• 🎨 Beautiful UI - Modern, clean design with a soothing earthy color palette

Bud is your AI-powered personal gardener who helps tend to your financial garden. Just chat naturally:

• "Add a $50 grocery expense to my checking account"
• "Transfer $200 from savings to my budget"
• "Create a new vacation fund account with $500"
• "Delete that coffee transaction from yesterday"

Bud uses OpenAI GPT to understand your requests and performs actions directly on your accounts.

• Framework: Next.js 14 (App Router)
• Database: PostgreSQL with Prisma ORM
• Authentication: Lucia Auth
• AI: OpenAI GPT-4o-mini with function calling
• Styling: Tailwind CSS
• Language: TypeScript

• Node.js 18+
• PostgreSQL database (or use a service like Neon, Supabase, Railway)
• OpenAI API key (for Bud AI features)

1. Clone the repository and install dependencies:

npm install

2. Create a .env file in the root directory:

DATABASE_URL="postgresql://username:password@host:5432/database?sslmode=require"
NEXT_PUBLIC_APP_URL="http://localhost:3000"
OPENAI_API_KEY="sk-..."

3. Generate Prisma client and push the schema to your database:

npm run db:generate
npm run db:push

4. Start the development server:

npm run dev

5. Open http://localhost:3000 in your browser.

• id: Unique identifier
• email: User email (unique)
• hashedPassword: Argon2 hashed password
• name: Optional display name

• id: Unique identifier
• name: Account name
• type: SAVINGS | BUDGET | ALLOWANCE | RETIREMENT | STOCK
• balance: Current balance (Decimal)
• userId: Owner reference

• id: Unique identifier
• amount: Transaction amount (Decimal)
• description: Transaction description
• date: Transaction date
• type: INCOME | EXPENSE | TRANSFER
• accountId: Associated account
• transferToAccountId: Destination account (for transfers)

• id: Unique identifier
• ownerId: Dashboard owner
• viewerId: User with access
• permission: VIEW | EDIT
• createdAt: Share creation date

• id: Unique identifier
• ownerId: Inviter
• recipientId: Optional (if user exists)
• email: Invitee email
• permission: VIEW | EDIT
• status: PENDING | ACCEPTED | DECLINED | EXPIRED

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run db:generate - Generate Prisma client
• npm run db:push - Push schema to database
• npm run db:migrate - Run migrations
• npm run db:studio - Open Prisma Studio

src/
├── app/
│   ├── (auth)/           # Auth pages (signin, signup)
│   ├── (dashboard)/      # Protected dashboard pages
│   ├── api/              # API routes
│   │   ├── auth/         # Auth endpoints
│   │   ├── accounts/     # Account CRUD
│   │   ├── transactions/ # Transaction CRUD
│   │   ├── transfers/    # Transfer operations
│   │   ├── invitations/  # Sharing invitations
│   │   ├── shares/       # Dashboard shares
│   │   └── chat/         # AI chat endpoint
│   ├── globals.css       # Global styles
│   ├── layout.tsx        # Root layout
│   └── page.tsx          # Landing page
├── components/
│   ├── dashboard/        # Dashboard components
│   │   ├── Bud.tsx       # AI assistant
│   │   ├── QuickActions.tsx
│   │   ├── ShareModal.tsx
│   │   └── ...
│   └── ui/               # Reusable UI components
├── lib/
│   ├── auth.ts           # Lucia auth configuration
│   ├── password.ts       # Password hashing utilities
│   ├── prisma.ts         # Prisma client
│   └── utils.ts          # Utility functions
└── prisma/
    └── schema.prisma     # Database schema

Built by Brennon

MIT