Faktorio.cz

Monorepo containing BE and FE for faktorio.cz app. A free open source app for invoicing targeted at self-employed OSVČ or tiny companies.

Tech stack

• Typescript
• React.js
• Drizzle ORM
• TRPC
• Turso
• Shadcn
• Cloudflare workers

How to run from scratch for local development

Prerequisites

• Node.js 22+
• pnpm
• Optionally
  • turso DB on your turso cloud account
  • google client ID for google login
  • mailjet API key for sending emails

You need to have turso DB setup. You only need google client ID for google login. Mailjet you only need if you want to send emails.

1. pnpm i
2. cd faktorio-fe && cp .env.example .env
3. cd faktorio-api && cp .dev.vars.example .dev.vars
4. fill in missing env vars in both files, keep empty those you don't want to use(mailjet, google client ID)
5. pnpm dev

How to generate new migrations

1. cd faktorio-api
2. pnpm generate

How to run migrations

1. cd faktorio-api
2. pnpm migrate

Migration do not run on CI. They must be run manually for now.

Project status

Project is under active development. The aim is to make this a number one invoicing app in Czech republic for freelancers and small companies.

Common issues

make sure to use pk_test clerk key. Clerk won't even load when you use production key on localhost

Planned features

are all listed in roadmap.md

Features

• generate invoice PDF
• extract entire invoice from any JPG/PNG or PDF
• search through invoices
• contact management(integrated with ARES)
• support for foreign currencies
• export invoices to Excel, CSV
• export invoices to XML for Czech tax authorities

Feature Comparison

Feature	Faktorio.cz	Fakturovac.cz	Fakturoid.cz	iDoklad.cz
Generate invoice PDF	✅	✅	✅	✅
Extract invoice from JPG/PNG/PDF	✅	❌	❌	❌
Search through invoices	✅	✅	✅	✅
Contact management (integrated with ARES)	✅	✅	✅	✅
Support for foreign currencies	✅	❌	✅	✅
Export invoices to Excel, CSV	✅	✅	✅	✅
Export invoices to XML for tax authorities	✅	✅	✅	✅
Send invoices to an email from the app	❌	✅	✅	✅
API for integrations	❌	❌	✅	✅

Note: Feature information for Fakturoid.cz and iDoklad.cz is based on common commercial offerings and may require verification.