ShopIt - E-commerce Platform

A modern e-commerce platform built with Flask, featuring vendor management, order tracking, and admin dashboard.

Features

• 🛍️ Product Management - Add, edit, and manage products with categories
• 👥 User Management - Customer registration and authentication
• 🏪 Vendor System - Multi-vendor marketplace support
• 🚚 Driver Management - Delivery driver registration and tracking
• 📊 Admin Dashboard - Comprehensive admin panel with analytics
• 💰 Accounting - Built-in accounting and VAT management
• 📱 Responsive Design - Mobile-friendly interface with Tailwind CSS

Tech Stack

• Backend: Python Flask
• Database: PostgreSQL (Nile Database)
• Frontend: HTML5, Tailwind CSS, JavaScript
• Authentication: Flask-Login
• Deployment: Vercel

Setup Instructions

Local Development

1. Clone the repository:

git clone https://github.com/andrekyle/shopit.git
cd shopit

2. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up environment variables:

cp .env.example .env
# Edit .env with your database credentials

5. Run the application:

python app.py

The application will be available at http://localhost:5004

Default Admin Login

• Email: admin@brandcartel.com
• Password: admin123

Deployment

This application is configured for deployment on Vercel with Nile Database.

Prerequisites

1. GitHub Repository: https://github.com/andrekyle/shopit.git
2. Vercel Account: Sign up at https://vercel.com
3. Nile Database: Configured and running

Environment Variables (Vercel)

Set the following environment variables in your Vercel dashboard:

SECRET_KEY=your-production-secret-key-change-this
POSTGRES_URL=postgres://0199cd7a-e98f-79db-935e-93827b9423b3:6e576d8f-193c-4587-9d8d-2f7bc60b16fc@us-west-2.db.thenile.dev/shopit
NILEDB_URL=postgres://0199cd7a-e98f-79db-935e-93827b9423b3:6e576d8f-193c-4587-9d8d-2f7bc60b16fc@us-west-2.db.thenile.dev/shopit
NILEDB_USER=0199cd7a-e98f-79db-935e-93827b9423b3
NILEDB_PASSWORD=6e576d8f-193c-4587-9d8d-2f7bc60b16fc
NILEDB_API_URL=https://us-west-2.api.thenile.dev/v2/databases/0199cd7a-e756-7fd6-aa7d-17c67c5ee715
NILEDB_POSTGRES_URL=postgres://us-west-2.db.thenile.dev/shopit

Quick Deploy to Vercel

1. Push to GitHub ✅ (Already completed)

   git push origin main

2. Deploy to Vercel:

   • Visit: https://vercel.com/new
   • Import from GitHub: andrekyle/shopit
   • Add environment variables from above
   • Deploy!

3. Alternative - Vercel CLI:

   npm i -g vercel
   vercel --prod

Database Setup

The application will automatically:

• Connect to Nile Database using the provided credentials
• Initialize database schema on first run
• Create admin user: admin@brandcartel.com / admin123

Post-Deployment

After deployment:

1. Visit your Vercel domain
2. Login with admin credentials
3. Configure site settings in admin panel
4. Add products and categories
5. Start selling!

Database

The application uses Nile Database (PostgreSQL) for production and SQLite for local development. The database schema is automatically created on first run.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.