README.md

FreeInvoice.dev

Free invoice generator. Client-side, PDF out, no sign-up.

FreeInvoice.dev · Issues

Stack

• TanStack Start on Vite
• Tailwind CSS v4
• React Hook Form + Zod
• @react-pdf/renderer
• Headless UI for a11y primitives
• oxlint + oxfmt
• Playwright for E2E

Getting started

Requires Node.js 24 and pnpm 10.

pnpm install
pnpm dev

Opens at http://localhost:3000.

Scripts

• pnpm dev — Vite dev server
• pnpm build — production build
• pnpm start — run the built server
• pnpm type-check — tsc --noEmit
• pnpm lint / pnpm lint:fix — oxlint
• pnpm format / pnpm format:check — oxfmt
• pnpm test:e2e — Playwright E2E
• pnpm test:e2e:playwright — Playwright with UI

Project layout

src/
├── app/            TanStack Router file-based routes
├── components/     shared UI (header, footer, preview drawer, …)
├── hooks/          shared React hooks
├── lib/            validation, icons, utilities
├── router.tsx      router setup
└── routeTree.gen.ts  generated — do not edit

Contributing

Issues and pull requests welcome. For anything substantial, open an issue first.

License

MIT — see LICENSE.md.

---

Built by João Pedro Schmitz.