Skip to content

Repository files navigation

FORGE

Open-source freelance OS - from proposal to payment.

FORGE is a self-hosted project management tool built for freelancers and small agencies. It replaces the scattered workflow of spreadsheets, Notion, and invoicing apps with one unified command center.

No accounts. No subscriptions. Runs in your browser.

Features

  • AI Proposals - Paste a client brief, get a polished proposal with spec, timeline, and budget. Works with Claude, OpenAI, Groq, DeepSeek, Kimi, Perplexity, OpenRouter, or local models via Ollama (bring your own key)
  • Project Pipeline - Kanban and grid views, task checklists, revision tracking, deadline alerts
  • Invoicing - Line items, PDF export, auto-generate on delivery, overdue detection
  • Time Tracking - Built-in timer with per-project tracking and hourly rate calculations
  • Client CRM - Star ratings, lifetime revenue, and full project history per client
  • Design Review - Share a link, clients pin comments directly on design screenshots
  • Automations - Auto-create projects from won proposals, auto-invoice on delivery
  • Analytics - Revenue heatmap, win rates, monthly goal tracking
  • Flexible Storage - localStorage (default), IndexedDB, or connect your own Supabase for cloud sync

Quick Start

git clone https://github.com/medtty/FORGE.git
cd FORGE
npm install
npm run dev

Open http://localhost:5173 - no accounts, no sign-ups, no credit cards.

AI Setup (Optional)

FORGE works without any AI keys - just skip the AI features. To enable them, go to Settings → AI and add a key for whichever provider you prefer:

Provider Key format Cost
Claude sk-ant-... Pay per use
OpenAI sk-... Pay per use
Groq gsk_... Free tier available
DeepSeek sk-... Very affordable
Kimi (Moonshot) sk-... Pay per use
Perplexity pplx-... Pay per use
OpenRouter sk-or-v1-... Free models available
Ollama (local) Free - install Ollama

API keys are stored in your browser only - never sent anywhere except directly to the provider.

Cloud Sync (Optional)

Data lives in localStorage by default. To sync across devices, create a free Supabase project, run the setup SQL from Settings → Storage, and add your credentials.

Self-Hosting

FORGE is a static React app with no server. Build and deploy anywhere:

npm run build
# Deploy the `dist/` folder to any static host

Vercel, Netlify, Cloudflare Pages, or your own nginx - all work.

Tech Stack

  • React 18 + TypeScript 5.6
  • Vite 6
  • Tailwind CSS 3
  • Zustand 5 (state + localStorage persistence)
  • Radix UI (accessible components)
  • Recharts (analytics)
  • Supabase (optional - user-owned cloud sync)

License

MIT - use it however you want.

About

Your freelance business, supercharged. From proposals to payments, manage your pipeline, track time, invoice clients, and let AI handle the busywork. All in one app you own.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages