Invoice Command
Free, open-source invoicing. Build an invoice in the browser with a live preview, dictate it by voice, download a PDF, email it, and get paid by card through Stripe. The hosted version is at invoicecommand.com.
- Invoice and estimate builder with live preview, three styles, and 400+ profession templates
- No account needed: drafts are saved in the browser; sign up to save invoices and send them
- Voice dictation: speak line items and details, and OpenAI turns them into form fields
- Payments: Stripe Connect lets clients pay invoices by card
- E-signatures on estimates, shareable invoice links, PDF export
- API, CLI, and MCP server (
packages/cli, packages/mcp) for creating and sending invoices from scripts or AI agents
Tech stack
Next.js 15 (App Router, Turbopack) · TypeScript · Tailwind CSS v4 + shadcn/ui · Postgres via Drizzle · Better Auth · Stripe Connect · Resend · OpenAI · Sentry · PostHog
Running it locally
Requires Node.js 22.12 or newer and a Postgres database (a free Neon project works).
npm install
# create .env.local with the variables below; DATABASE_URL and BETTER_AUTH_SECRET are enough to start
npm run db:push # creates the tables
npm run dev # http://localhost:3005
| Variable | Needed for |
|---|
DATABASE_URL | Postgres connection string (required) |
BETTER_AUTH_SECRET | Session signing, any long random string (required) |
NEXT_PUBLIC_APP_URL | Absolute links in emails and share links, e.g. http://localhost:3005 |
STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET | Card payments via Stripe Connect (Express accounts) |
RESEND_API_KEY, RESEND_FROM_EMAIL, RESEND_APP_FROM_EMAIL, RESEND_REPLY_TO | Emailing invoices |
SUPPORT_EMAIL | Inbox that receives the in-app support form |
OPENAI_API_KEY | Voice dictation |
CRON_SECRET | The scheduled jobs in vercel.json |
NEXT_PUBLIC_SENTRY_DSN, NEXT_PUBLIC_POSTHOG_KEY, NEXT_PUBLIC_POSTHOG_HOST | Error tracking and analytics (optional) |
Features whose keys are missing stay off; the invoice builder itself works with just the database and auth secret.
Tests
npm test # Jest unit and component tests
npm run test:e2e # end-to-end tests in a real browser
The end-to-end tests use e2e: an AI agent drives the app through flows like building an invoice, and exact assertions check the results. Agent steps call a model through the Vercel AI Gateway, so set AI_GATEWAY_API_KEY (or vercel link the project). The runner starts the dev server itself.
Contributing
Issues and pull requests are welcome. See CONTRIBUTING.md. Contributors sign a short CLA on their first pull request.
License
AGPL-3.0. You can use, modify, and self-host Invoice Command freely. If you run a modified version as a network service, you must make your source code available to its users under the same license.
