How to vibe codeWave

Prerequisites

• Node.jsfree

  Required runtime for running the full-stack Next.js application and toolchain.

• GitHubfree

  Version control and deployment pipeline source repository.

AI coding tools

• Claude Code

  Best-in-class multi-file agentic coding tool for scaffolding a complex full-stack financial ledger app from scratch.

• Cursor

  IDE for reviewing ledger diffs and tweaking UI components for invoices and financial statements.

Build guide

1. 01Project Scaffolding & Database Schema

   Initialize the Next.js project with Tailwind CSS, configure Turso SQLite connection via Drizzle ORM, and set up the foundational double-entry accounting schema.

   Scaffold a new Next.js project with Tailwind CSS, TypeScript, and Drizzle ORM configured for Turso SQLite. Create a robust double-entry bookkeeping database schema. Tables must include: accounts (id, name, type [asset, liability, equity, revenue, expense], normal_balance), transactions (id, date, description, reference), and journal_entries (id, transaction_id, account_id, debit, credit). Ensure constraints enforce that total debits equal total credits for every transaction. Add seed data for a standard chart of accounts.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Authentication & User Dashboard

   Implement better-auth for single-user or multi-tenant isolation, and build the main financial dashboard summarizing cash flow, income, and expenses.

   Integrate better-auth into the Next.js application with email/password credentials. Create a protected dashboard layout with shadcn/ui components. Build server actions and UI widgets that query the database to display real-time financial metrics: total income, total expenses, net profit, and recent transactions mapped from the double-entry journal ledger.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Invoicing & Estimate Engine

   Build an invoice creation tool with line items, tax calculations, PDF rendering, and status tracking.

   Build a comprehensive invoicing and estimates module in Next.js. Create database tables for invoices, invoice_items, customers, and payments. Implement a form interface allowing users to add line items, apply taxes, and save drafts or send invoices. Create a clean printable/PDF view for invoices using react-pdf or Tailwind print styles. Implement invoice status transitions: draft, sent, viewed, paid.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Manual Expense Tracking & Receipt OCR

   Implement manual expense logging alongside an OCR upload pipeline using OpenAI Vision to extract vendor names, totals, and line items from uploaded receipt images.

   Build an expense tracking module with receipt capture. Create an endpoint that accepts uploaded receipt images, stores them securely, and sends them to the OpenAI API (GPT-4o mini) with a structured JSON output prompt to extract vendor name, date, total amount, tax, and line items. Automatically map the extracted data to create a balancing journal entry debiting an expense account and crediting accounts payable or cash.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Financial Reports (P&L & Balance Sheet)

   Construct accounting report generators that aggregate journal lines into Profit & Loss and Balance Sheet statements.

   Build a financial reporting engine that generates real-time Profit & Loss (Income Statement) and Balance Sheet reports from the double-entry journal entries. Create a reporting page with date range pickers (this month, year-to-date, custom) that groups revenue and expense accounts for the P&L, and asset, liability, and equity accounts for the Balance Sheet, ensuring balance sheet identity checks (Assets = Liabilities + Equity).

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for Wave