Skip to content

capaj/faktorio

Repository files navigation

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

  • add ability to export XMLs for DPH and Kontrolni hlaseni, support monthly and quarterly cadence
  • add feature to import expense invoices by OCRing them with google gemini 2.0
  • be able to run local-first/fully offline using local sqlite db
  • DPH priznani at the end of the year
  • automated DPH and Kontrolni hlaseni submission to ADIS every month/quarter for you with automated pupeteer script
  • integrate with Fio bank API to be able to mark invoices as paid when you receive money
  • ability to import contact and invoice data from fakturoid

Features

  • generate invoice PDF
  • search through invoices
  • contact management(integrated with ARES)
  • support for foreign currencies nová faktura
  • export invoices to Excel, CSV

Free Alternatives

  • 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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages