Slimbooks

A secure, self-hosted billing and invoice management application built with React, TypeScript, and SQLite. Perfect for small businesses and freelancers who want complete control over their financial data.

Security-First
Docker Ready
Raspberry Pi Optimized
View on GitHub Get Started
Docker Quick Start 
# Clone the repository
git clone <your-repository-url>
cd slimbooks

# Generate secure secrets
./scripts/generate-secrets.sh

# Deploy with Docker
./scripts/deploy.sh

Key Features

Streamline your financial management with powerful tools

Business Management

  • Dashboard: Real-time financial overview with interactive charts
  • Client Management: Complete client profiles with contact details and history
  • Professional Invoices: Customizable templates with line items, taxes, and shipping
  • Expense Tracking: Categorized expense management with receipt uploads
  • Financial Reports: Revenue and expense analytics with date filtering

Security & Privacy

  • Enterprise Security: Rate limiting, input validation, and security headers
  • JWT Authentication: Secure token-based authentication with 2FA support
  • Self-Hosted: Complete data ownership - no third-party data sharing
  • Encrypted Storage: Secure SQLite database with encrypted sensitive data

Deployment

  • Docker Ready: One-command deployment with Docker Compose
  • Raspberry Pi: Optimized for ARM devices and low-power systems
  • Fast Setup: Automated scripts for quick deployment
  • Portable: SQLite database - easy backup and migration

Modern Tech Stack

Built with performance and developer experience in mind

Frontend

React 18
UI Library
TypeScript
Language
Vite
Build Tool
shadcn/ui + Tailwind CSS
Styling & UI
Lucide Icons
Icon Library

Backend

Node.js
Runtime
Express
Web Framework
SQLite
Database
Recharts
Charts

Security & Deployment

Helmet Rate Limiting JWT bcrypt Docker Docker Compose

Quick Start Guide

Get Slimbooks up and running in no time

Docker Deployment (Recommended) 

# Clone the repository
git clone <your-repository-url>
cd slimbooks

# Generate secure secrets
./scripts/generate-secrets.sh

# Deploy with Docker
./scripts/deploy.sh

Access your app at http://localhost:8080

Raspberry Pi Setup 

# Prepare your Raspberry Pi
curl -fsSL https://raw.githubusercontent.com/rbenzing/slimbooks/main/scripts/setup-raspberry-pi.sh | bash

# Deploy the application
./scripts/deploy.sh

Development Setup 

# Install dependencies
npm install

# Start development servers
npm run dev

Frontend: http://localhost:8080 • Backend: http://localhost:3002

Configuration

Customize Slimbooks to fit your needs

Environment Variables

The application uses environment variables for secure configuration:

# Security (REQUIRED - change in production)
JWT_SECRET=your-secure-64-character-secret
JWT_REFRESH_SECRET=your-secure-refresh-secret
SESSION_SECRET=your-secure-session-secret

# Network
CORS_ORIGIN=http://localhost:8080
PORT=3002

# Features
ENABLE_2FA=true
ENABLE_DEBUG_ENDPOINTS=false

Use ./scripts/generate-secrets.sh to create secure secrets automatically.

Database

  • SQLite: Lightweight, serverless database perfect for self-hosting
  • Automatic Backups: Daily automated backups with rotation
  • Data Portability: Single file database for easy migration
  • No External Dependencies: Everything runs locally

Security Features

Robust protection for your sensitive financial data

Rate Limiting

Protection against brute force attacks (100 req/15min)

JWT Authentication

Secure token-based auth with configurable expiration

Input Validation

Server-side validation prevents injection attacks

Security Headers

Comprehensive protection with Helmet.js

Account Lockout

Automatic lockout after failed login attempts

2FA Support

Two-factor authentication for enhanced security

Audit Logging

Request/response logging for security monitoring

Documentation

Dive deeper into Slimbooks

Deployment Guide Theme System Contributing

Management Commands

Control your Slimbooks instance

View application logs

docker-compose logs -f

Backup database

/usr/local/bin/slimbooks-backup

Update deployment

./scripts/deploy.sh

Generate new secrets

./scripts/generate-secrets.sh