Sparkshed

A simple inventory management app for SparkShop.

Description

An inventory management system that allows for the creation of Items, Kits, Orders, and Deliveries.

Quick Start (Local Development)

Using SQLite (default, no external database needed)

# Install dependencies
pip install -r requirements.txt

# Run migrations
python manage.py migrate

# Create a superuser (admin/admin)
python manage.py createsu

# Start the development server
python manage.py runserver

Then open http://localhost:8000 in your browser and log in with admin/admin.

Using Docker (with SQLite)

docker-compose up

The app will be available at http://localhost:8000.

Using Docker with PostgreSQL

DATABASE_URL=postgresql://sparkshed:sparkshed@db:5432/sparkshed \
docker-compose --profile postgres up

Configuration

Environment variables are optional. See .env.example for all available options.

• SECRET_KEY: Django secret key (auto-generated by default)
• DATABASE_URL: Database connection string (SQLite used if not set)
• RENDER_EXTERNAL_HOSTNAME: For Render.com deployments

To-do

• Update kit page list view
• Implement ordering of kits and items
• Fix inconsistent styling
• Add card highlighting to dashboard stats
• Add item descriptions
• Fix critical delivery bugs (POST-only creation)
• Simplify local dev setup (no MySQL required)
• Update item grid to show which kit(s) each item is part of
• Implement deliveries completion
• Update dashboard with something useful
• Fix kit item deletion so delete happens at item level

License

This project is licensed under the MIT License.