README.md

Oar

A sovereign, local-first bill management system built with Next.js 16, SQLite, and Drizzle ORM.

Getting Started

Prerequisites

• Node.js 24+
• npm

Installation

# Clone and enter the project
cd oar

# Use correct Node version
nvm use

# Install dependencies
npm ci

# Initialize the database
npm run db:push

Development

npm run dev

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

Database Commands

npm run db:push      # Push schema changes to SQLite
npm run db:generate  # Generate migration files
npm run db:studio    # Open Drizzle Studio GUI

Tech Stack

• Framework: Next.js 16 (App Router)
• Database: SQLite with WAL mode
• ORM: Drizzle
• Validation: Zod
• Styling: Tailwind CSS