https://github.com/capaj/faktorio
invoicing solution for self-employed contractors in Czech republic
https://github.com/capaj/faktorio
czech invoicing invoicing-platform
Last synced: 7 months ago
JSON representation
invoicing solution for self-employed contractors in Czech republic
- Host: GitHub
- URL: https://github.com/capaj/faktorio
- Owner: capaj
- Created: 2024-01-29T13:48:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-01T05:00:14.000Z (7 months ago)
- Last Synced: 2025-04-01T05:29:24.152Z (7 months ago)
- Topics: czech, invoicing, invoicing-platform
- Language: TypeScript
- Homepage: https://faktorio.cz
- Size: 2.56 MB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# 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](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/