Oreko

The invoicing platform you actually own.

Open-source. Self-hosted. Quotes, invoices, contracts, payments, and analytics in one place.
Zero subscription fees. Zero lock-in.

Website · Documentation · Issues

Why Oreko

Invoicing tools are expensive, and your data is trapped. Most platforms use your client data and payment history as leverage to keep you locked in. It shouldn't work that way.

A fresh approach to quoting and invoicing. Oreko gives you a visual block-based builder for creating professional quotes that convert to invoices with zero data re-entry — inspired by modern tools like Notion and Linear.

Open-source and community-driven. Self-host for free with full control over your data, or use the managed cloud version. AGPL v3 licensed.

What You Can Do With Oreko

• Visual Quote Builder
• Invoicing with one-click conversion
• Client Management
• Contracts, payments, and analytics

Visual Quote Builder

Build branded quotes in your visual editor. Add line items, apply discounts, set payment terms, and send to clients for review.

Invoicing with one-click conversion

Create invoices from scratch or convert accepted quotes with one click. Track payment status in real time.

Client Management

Centralized client database with full history, lifetime value tracking, and contact management.

Contracts, payments, and analytics

Feature	Description
E-Signature Capture	Legally compliant electronic signatures (E-SIGN, UETA)
Stripe Payment Integration	Accept credit cards and ACH payments via Stripe Connect
PDF Generation	Professional PDF exports for quotes and invoices
Email Notifications	Automated email workflows for quotes, invoices, and reminders
Dashboard Analytics	Revenue trends, quote conversion rates, invoice status, and client insights
Contract Templates	Draft contracts from templates, send for e-signature
Rate Card System	Predefined services and pricing tiers for quick quoting
Milestone Payments	Support for deposits, milestones, and recurring payments
Modular Workspace	Enable only the modules you need
Self-Hosted	Full control over your data with Docker deployment

Quick Start

Using Docker for Services

The base docker-compose.yml runs supporting services (PostgreSQL, Mailpit) while you run Next.js locally:

git clone https://github.com/orekoapp/oreko.git
cd oreko
cp apps/web/.env.example apps/web/.env.local   # Next.js loads .env.local from apps/web/
docker-compose up -d                            # Start Postgres and Mailpit
pnpm install
pnpm db:migrate
pnpm dev

Open http://localhost:3000

Manual Installation (No Docker)

git clone https://github.com/orekoapp/oreko.git
cd oreko
pnpm install
cp apps/web/.env.example apps/web/.env.local   # Next.js loads .env.local from apps/web/
# Ensure PostgreSQL is running and DATABASE_URL is set in apps/web/.env.local
pnpm db:migrate
pnpm dev

See the full setup guide for detailed instructions.

Stack

• TypeScript 5.x
• Next.js 14+ (App Router)
• Prisma + PostgreSQL
• Shadcn UI + Tailwind CSS
• Stripe Connect for payments
• Turborepo monorepo
• Docker for deployment

Contributing

We welcome contributions! See our Contributing Guide for details.

Check specs/PRODUCT_SPEC.md for the roadmap and specs/TECHNICAL_SPEC.md for architecture details.

# Fork, clone, then:
pnpm install
pnpm dev          # Start dev server
pnpm test         # Run tests
pnpm lint         # Lint codebase

License

Oreko is open-source software licensed under the GNU Affero General Public License v3.0.

Support

• Website: oreko.app
• Documentation: oreko.app/docs
• Issues: GitHub Issues
• Email: support@oreko.app

---

Built with care by the Oreko community.