Credith is a complete point-of-sale and credit management system built for retail businesses in Honduras. It combines a React dashboard with an Express REST API to handle everything from CAI-compliant tax invoicing to installment credit plans, multi-store inventory tracking, and revenue reporting — all behind a role-based access system.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/RoyGeova07/Credith/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get Credith running locally in minutes with Docker Compose and seed data.
API Reference
Browse every endpoint — users, bills, products, payment plans, and more.
Core Concepts
Understand roles, CAI invoicing, credit plans, and inventory management.
Deployment
Deploy to production with Docker Compose and environment configuration.
What Credith Does
Credith is designed for multi-store retail businesses that issue tax-compliant invoices and offer credit to customers. The system has three distinct user roles — Owner, Admin, and Employee — each with a tailored view of the dashboard.CAI Invoicing
Issue government-authorized invoices with sequential bill numbers and expiry ranges.
Credit Plans
Create installment plans with monthly schedules, interest rates, and payment tracking.
Inventory
Track per-store product stock that automatically decrements on every sale.
Multi-Store
Manage multiple stores under one company, each with its own staff and inventory.
Reports
View revenue, product performance, and store KPIs from the Owner dashboard.
Authentication
JWT-based auth via HTTP cookies with role-aware session management.
Getting Started
Clone and configure
Clone the repository and copy the example environment files for the backend service.
Start with Docker Compose
Run
docker compose up to bring up the PostgreSQL database, backend API, and React frontend simultaneously.Run migrations and seed data
Execute database migrations with
pnpm migrate, then seed base roles and demo data so the app is ready to use.Credith is built for Honduran tax compliance. CAI (Código de Autorización de Impresión) numbers are required to issue valid invoices. See CAI & Invoicing for details.