{"id":15354943,"url":"https://github.com/capaj/faktorio","last_synced_at":"2025-04-04T18:18:54.168Z","repository":{"id":232031118,"uuid":"749835022","full_name":"capaj/faktorio","owner":"capaj","description":"invoicing solution for self-employed contractors in Czech republic","archived":false,"fork":false,"pushed_at":"2025-04-01T05:00:14.000Z","size":2680,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-01T05:29:24.152Z","etag":null,"topics":["czech","invoicing","invoicing-platform"],"latest_commit_sha":null,"homepage":"https://faktorio.cz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/capaj.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-29T13:48:41.000Z","updated_at":"2025-04-01T05:00:17.000Z","dependencies_parsed_at":"2024-04-07T14:43:37.428Z","dependency_job_id":"67ac5c44-a8c3-4892-afa8-d60e80141e02","html_url":"https://github.com/capaj/faktorio","commit_stats":{"total_commits":94,"total_committers":1,"mean_commits":94.0,"dds":0.0,"last_synced_commit":"d16d9d257c598100ab645ea65017c15596257457"},"previous_names":["capaj/faktorio"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Ffaktorio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Ffaktorio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Ffaktorio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Ffaktorio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/capaj","download_url":"https://codeload.github.com/capaj/faktorio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226191,"owners_count":20904467,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["czech","invoicing","invoicing-platform"],"created_at":"2024-10-01T12:21:46.537Z","updated_at":"2025-04-04T18:18:54.162Z","avatar_url":"https://github.com/capaj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Faktorio.cz\n\nMonorepo containing BE and FE for faktorio.cz app. A free open source app for invoicing targeted at self-employed OSVČ or tiny companies.\n\n## Tech stack\n\n- Typescript\n- React.js\n- Drizzle ORM\n- TRPC\n- Turso\n- Shadcn\n- Cloudflare workers\n\n## How to run from scratch for local development\n\n### Prerequisites\n\n- Node.js 22+\n- pnpm\n- turso DB on your turso cloud account\n\nYou need to have turso DB setup. You only need google client ID for google login.\nMailjet you only need if you want to send emails.\n\n1. `pnpm i`\n2. `cd faktorio-fe \u0026\u0026 cp .env.example .env`\n3. `cd faktorio-api \u0026\u0026 cp .dev.vars.example .dev.vars`\n4. fill in missing env vars in both files, keep empty those you don't want to use(mailjet, google client ID)\n5. `pnpm dev`\n\n## How to generate new migrations\n\n1. `cd faktorio-api`\n2. `pnpm generate`\n\n## How to run migrations\n\n1. `cd faktorio-api`\n2. `pnpm migrate`\n\nMigration do not run on CI. They must be run manually for now.\n\n## Project status\n\nProject is under active development. The aim is to make this a number one invoicing app in Czech republic for freelancers and small companies.\n\n## Common issues\n\nmake sure to use `pk_test` clerk key. Clerk won't even load when you use production key on localhost\n\n## Planned features\n\nare all listed in [roadmap.md](roadmap.md)\n\n## Features\n\n- generate invoice PDF\n- search through invoices\n- contact management(integrated with ARES)\n- support for foreign currencies ![nová faktura](images/cdc8dd7ed308322d42c6d5af6b481be7f7dff3cca6de0dcb16921f0e6f44ccbb.png)\n- export invoices to Excel, CSV\n\n## Free Alternatives\n\n### https://www.fakturovac.cz/\n\n- has most features same as faktorio, but it does not have any other currencies than CZK, so you cannot invoice in EUR for example\n\n## Commercial Alternatives\n\n### https://www.fakturoid.cz/\n\n### https://www.idoklad.cz/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapaj%2Ffaktorio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcapaj%2Ffaktorio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapaj%2Ffaktorio/lists"}