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
• turso DB on your turso cloud account

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
• search through invoices
• contact management(integrated with ARES)
• support for foreign currencies
• export invoices to Excel, CSV

Free Alternatives

https://www.fakturovac.cz/

• has most features same as faktorio, but it does not have any other currencies than CZK, so you cannot invoice in EUR for example

Commercial Alternatives

https://www.fakturoid.cz/

https://www.idoklad.cz/