AMMA-GHANA/amma_cms

website(cms) for Asokore Mampong Municipal Assembly # AMMA CMS - Asokore Mampong Municipal Assembly Content Management System ## Overview Modern Django-based CMS for managing the AMMA website with Tailwind CSS frontend. ## Tech Stack - **Backend**: Django 5.0.8, Python 3.13 - **Frontend**: Tailwind CSS, Alpine.js - **Database**: SQLite (flexible via DATABASE_URL for MySQL/PostgreSQL) - **Rich Text Editor**: CKEditor 5 - **Admin Theme**: django-admin-interface ## Project Structure ``` amma_cms/ ├── config/ # Project settings │ ├── settings.py # Django settings (consolidated) │ ├── urls.py │ ├── wsgi.py │ └── asgi.py ├── apps/ # Django applications │ ├── core/ # Homepage & site settings │ ├── news/ # News management │ ├── projects/ # Projects management │ ├── staff/ # Staff/Leadership │ ├── services/ # Services │ ├── documents/ # Downloads │ ├── gallery/ # Photo gallery │ └── contact/ # Contact forms ├── templates/ # HTML templates ├── theme/ # Tailwind CSS app │ └── static_src/ # Tailwind source files ├── static/ # Static files (CSS, JS) ├── media/ # User uploads ├── requirements.txt # Python dependencies ├── Makefile # Development workflow commands └── passenger_wsgi.py # cPanel deployment ``` ## Setup Instructions ### 1. Create Virtual Environment ```bash python3 -m venv venv source venv/bin/activate # Linux/Mac # or venv\Scripts\activate # Windows ``` ### 2. Install Dependencies ```bash pip install -r requirements.txt # or using Makefile make install ``` ### 3. Environment Variables Copy `.env.example` to `.env` and update values: ```bash cp .env.example .env ``` ### 4. Run Migrations ```bash python manage.py migrate ``` ### 5. Create Superuser ```bash python manage.py createsuperuser ``` ### 6. Run Development Server ```bash python manage.py runs …