Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

simsustech/slimfact

Repository files navigation

SlimFact

Streamlined invoicing made easy

SlimFact is a powerful invoicing solution designed to simplify your billing process. Whether you’re a small business owner, freelancer, or enterprise, SlimFact offers seamless invoice management with the following features:

  1. Immutable invoices:

    • Once an invoice is opened, it remains unchanged. No accidental modifications or discrepancies.
    • Fully rendered in the browser, eliminating the need for additional PDF generation packages.
  2. Flexible billing:

    • For orders that may undergo changes, SlimFact allows you to create bills.
    • Bills can be seamlessly converted to receipts once paid, maintaining a clear transaction history.
    • If the client requests an invoice, receipts can be converted to an invoice with a single click.
  3. Efficient UUID Access:

    • Each invoice is uniquely identified by a UUID (Universally Unique Identifier).
    • Clients can access their invoices anytime using their unique identifier.

SlimFact streamlines your invoicing process, ensuring accuracy, security, and convenience. Say goodbye to manual paperwork and embrace hassle-free billing with SlimFact! πŸš€πŸ’‘

Features

  • OpenID Connect (OIDC) authentication.
  • API can be used headless if desired.
  • Ability to use decimals in invoice line quantity.
  • Define the tax rate per invoice line and define wether or not the price includes or excludes tax, and automatically calculate the correct amount.
  • Send invoices in different languages by defining the locale on invoice level.
  • Clients can easily pay their invoices or bills online with the help of a payment service provider.
    • Mollie
      • Support for multiple profiles.
      • Accept down payments.
      • Refund payments.
  • Support for tracking cash or bank transaction payments.

Documentation

Invoice status flowchart

Self hosted

You will need a running Caddy container.

wget https://raw.githubusercontent.com/simsustech/slimfact/main/docker-compose.yaml
wget https://raw.githubusercontent.com/simsustech/slimfact/main/.env.example -O .env
mkdir env
nano -L .env # Change environment
nano -L env/POSTGRES_PASSWORD # Enter postgress password
nano -L env/OTP_SECRET # Enter OTP secret, use openssl rand -base64 32
nano -L env/OIDC_COOKIES_KEYS # Enter OIDC cookies keys, use openssl rand -base64 32, comma separated
docker compose up
docker exec -it slimfact-database-1 /bin/sh
MODULARAPI_ADMIN_PASSWORD=yourpassword npm run seed:data

You can now login with admin@slimfact.app / yourpassword.

Developers

SlimFact is built on top of Modular API. You will need an account for private NPM access.

git clone https://github.com/simsustech/slimfact.git
cd slimfact
pnpm i
docker compose -f docker-compose.dev.yaml up
cd packages/api
POSTGRES_PASSWORD=ufgouifdgjdfg POSTGRES_DB=slimfact pnpm run migrate:latest
POSTGRES_PASSWORD=ufgouifdgjdfg POSTGRES_DB=slimfact pnpm run seed:fake
pnpm run dev

License

Copyright Β© simsustech 2024-present

ELv2 License

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /