Tikondwe138/entertainment-solutions-malawi

A centralized creative-tech hub designed to document, showcase, and automate the management of all entertainment and technology projects in Malawi. The platform combines a Python/FastAPI backend with a SvelteKit frontend to create a dynamic, interactive repository of project media, case studies, guides, and documentation. # Entertainment Solutions Malawi (Ent-Sol-Malawi) A centralized hub for documenting, showcasing, and automating creative-tech projects in Malawi. This repository combines Python (FastAPI) and SvelteKit to provide a dynamic platform for media, case studies, guides, and automation tools. --- ## Table of Contents 1. Overview 2. Directory Structure 3. Features 4. Getting Started 5. Scripts & Automation 6. Contributing 7. License --- ## Overview Ent-Sol-Malawi is designed to be the central repository for all entertainment and technology projects in Malawi. It stores project media, documentation, and metadata while providing automation scripts for indexing and thumbnail generation. The SvelteKit frontend provides an interactive interface for browsing and filtering projects, while the Python backend powers data processing and API endpoints. --- ## Directory Structure ent-sol-malawi/ ├─ docs/ # MkDocs site / case studies + guides ├─ backend/ │ ├─ app/ │ │ ├─ main.py # FastAPI app │ │ └─ api/ # Endpoints for projects, media, reports │ ├─ requirements.txt │ └─ scripts/ │ ├─ build_index.py # Scan media & build index.json/db │ └─ thumb_generator.py # Generate thumbnails automatically ├─ frontend/ │ ├─ svelte.config.js │ ├─ package.json │ └─ src/ │ ├─ routes/ # Pages & API endpoints │ ├─ lib/ # Reusable components │ ├─ stores/ # State management │ └─ assets/ # CSS, images, icons ├─ media/ │ ├─ project-a/ │ │ ├─ screenshot-1.png │ │ └─ meta.yaml │ └─ ... ├─ .github/ │ └─ workflows/ci.yml # CI/CD workflow ├─ README.md └─ index.json # Generated index of projects yaml Copy code --- ## Features - **Central Repository**: Organize all projects, media, and metadata in one location. - **Automation**: Scripts for indexing projects (`build_index.py`) and generating thumbnails (`thumb_generator.py`). - **Interactive Frontend**: Browse, filter, and explore projects with SvelteKit. - **Documentation**: M …