CreditBook is a Django-based business management web app for tracking sales, customers, debts, expenses, income, and staff. It is designed for small businesses that want a simple dashboard-driven workflow with a modern UI.
- Dashboard with quick business metrics
- Sales tracking with payment method support
- Customer records and debt history
- Outstanding debt tracking with reminder links
- Expense and income logging
- Staff management with login-capable accounts
- Demo data seeding for exploration
- Python 3.10+
- pip
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py runserverOpen http://127.0.0.1:8000/ in your browser.
python manage.py seed_demo./build.shSet these environment variables before running the build script if you want a superuser created automatically:
export DJANGO_SUPERUSER_USERNAME=admin
export DJANGO_SUPERUSER_EMAIL=admin@example.com
export DJANGO_SUPERUSER_PASSWORD=strong-passwordsylvaline_ventures/
├── build.sh
├── manage.py
├── requirements.txt
├── sylvaline/
│ ├── settings.py
│ └── urls.py
└── core/
├── models.py
├── views.py
├── forms.py
├── templates/
└── management/commands/seed_demo.py
You can adjust business defaults in sylvaline/settings.py, including:
- BUSINESS_NAME
- BUSINESS_CURRENCY
- TIME_ZONE
For production, set a strong secret key and configure allowed hosts before deployment. The app is already set up to use Django’s built-in authentication and staff accounts.
This project is ready for Northflank with a standard Procfile and Gunicorn entrypoint.
Recommended environment variables:
SECRET_KEYDEBUG=FalseALLOWED_HOSTS=your-domain.com,localhostDATABASE_URL=postgres://...(optional; SQLite is used by default locally)
The app will start with:
gunicorn --bind 0.0.0.0:${PORT:-8000} sylvaline.wsgi:application