A simple, powerful and easy to use Point of Sale (POS) system.

• Dashboard Page with statistics and graphs
• Products, Product categories Management
• Customers Management
• Suppliers Management
• Sales Management
• Stripe, PayPal, Cash and M-Pesa payment methods
• Support for multiple branches
• Role Based Access Control (RBAC)

The Ultimate POS application can be installed using Docker or manually.

For Docker installation, follow the Docker Setup Guide.

1. Clone the repository:

   git clone https://github.com/kagemanjoroge/ultimate_pos.git && cd ultimate_pos/django_pos

2. Create a virtual environment, activate it, and install the requirements:

   python3 -m venv venv; source venv/bin/activate; pip install -r requirements.txt

3. Create a .env file based on the .example.env template:

   cp .example.env .env

4. Update the .env file with your database credentials and other settings.
5. Run the migrations:

   python manage.py migrate

6. Create a superuser account:

   python manage.py createsuperuser

7. Collect static files:

   python manage.py collectstatic --no-input

8. Start the development server:

   python manage.py runserver

9. Access the application at http://localhost:8000
10. Rock and roll!