Fix/UI

.gitignore

@@ -126,3 +126,5 @@ shopyo/static/modules/
 
 # ignore secrets
 config.json
+
+exp/

README.md

@@ -1,145 +1,170 @@
+# pythoncms
 
-<div align="center">
+[![First Timers Only](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://www.firsttimersonly.com/)
 
+**The fastest way to start a CMS in Python.** Build production-grade sites with zero-config, modular themes, and a powerful content API.
 
+## 🚀 Quickstart
 
-<img src="https://github.com/shopyo/pythoncms/raw/main/assets/logo.png" width="200"/>
+The new unified CLI makes it easier than ever to get started:
 
-<br><br>
+```bash
+pip install pythoncms
+pythoncms start mysite --run
+```
 
-[![First Timers Only](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://www.firsttimersonly.com/)
+This single command will:
+1. Create your project directory.
+2. Generate a secure `.env` file.
+3. Initialise the database.
+4. Seed the default admin user.
+5. Start the development server.
 
-🇲🇺
+Open: `http://localhost:5000/dashboard`  
+Login: `admin@domain.com` / `pass`
 
-</div>
+---
 
+## 🛠️ Unified CLI Commands
 
+Manage your entire project from one place:
 
-# Welcome to pythoncms
+- `pythoncms start <name>`: Create a new project.
+- `pythoncms run`: Start the dev server.
+- `pythoncms initialise`: Set up database and assets.
+- `pythoncms seed`: Reset default data.
+- `pythoncms deploy`: Generate production files (Dockerfile, docker-compose.yml).
+- `pythoncms --version`: Check your version.
 
-## Try
+---
 
-![](https://github.com/shopyo/pythoncms/raw/main/assets/term.gif)
+## 🚀 Production Deployment
 
-In virtual env
+Deploying your CMS with a production-grade Nginx reverse proxy is now a single command:
 
-```
-pip install pythoncms
-pythoncms start mysite
-cd mysite
-shopyo initialise
-flask shopyo-seed
-flask --debug run
+```bash
+pythoncms deploy
 ```
 
-If .env file not created, create .env file with content
+This generates:
+- **Dockerfile**: Optimized for Gunicorn performance.
+- **nginx.conf**: Configured for request buffering and fast static file serving.
+- **docker-compose.yml**: Orchestrates the app and Nginx containers.
 
-```.env
-ACTIVE_FRONT_THEME = 'editorial'
-ACTIVE_BACK_THEME = 'sneat'
-APP_NAME = 'Demo'
-ACTIVE_ICONSET = 'boxicons'
-SITE_TITLE = 'Site title'
-SITE_DESCRIPTION = 'Site title'
-```
+### Quick Start
+1. Run `pythoncms deploy`.
+2. (Optional) Edit `nginx.conf` to add your domain.
+3. Run `docker-compose up --build -d`.
 
-## Local dev
+Your site will be live on port 80 with Nginx handling all incoming traffic.
 
-Install package
+---
 
-! Important: Please create and activate a virtual environment.
+## 📡 REST API
 
-```
-python -m pip install -e .
-```
-Then initialise
+Your content is automatically exposed via a JSON API.
 
-```
-cd pythoncms
-shopyo initialise
-flask --debug run
-```
+**Endpoint:** `/api/v1/<content_type_name>`
 
-for migrating
+### Pagination & Sorting
+- `?limit=10&offset=0`
+- `?sort_by=created_at&order=desc`
 
-```
-flask db migrate
-flask db upgrade
-```
+### Authentication (Optional)
+Set `API_TOKEN` in your `.env` to secure the API.
+Requests must then include header: `Authorization: Bearer <API_TOKEN>`
 
-run
+---
 
-```
-flask --debug run
-```
+## ⚙️ Configuration
 
-dashboard
+Your project settings are managed via the `.env` file in your root directory.
 
-login with `admin@domain.com` | `pass`
-```
-http://127.0.0.1:5000/dashboard/
+### Database Connection
+By default, `pythoncms` uses SQLite. To use a different database, update the `SQLALCHEMY_DATABASE_URI`:
+
+```bash
+# SQLite (default)
+SQLALCHEMY_DATABASE_URI = "sqlite:///mysite.db"
+
+# PostgreSQL
+SQLALCHEMY_DATABASE_URI = "postgresql://user:password@localhost/dbname"
 ```
 
-## Theme
+### Other Settings
+- `APP_NAME`: Change the display name of your application.
+- `SECRET_KEY`: Used for session encryption. Automatically generated on `start`.
+- `ACTIVE_FRONT_THEME`: Choose between `editorial` or `hyperspace`.
+- `ACTIVE_BACK_THEME`: Choose between `sneat` or `sbadmin`.
 
-Themes are located at '/static/themes/'
+---
 
-Each front theme must have
+## ✨ Features
 
-```
-index.html
-contact.html
-page.html
-```
+- 🏗️ **Content Types:** Define custom schemas with JSON.
+- 🎨 **Theme Support:** Switch between beautiful, responsive themes instantly.
+- 🔐 **Built-in Auth:** Secure admin and user management out of the box.
+- 🍱 **Modular Architecture:** Extend functionality with a robust plugin system.
+- 🖼️ **Media Management:** Simple upload and resource handling.
+- ⚡ **Flask Powered:** Minimal, fast, and easy to customize.
 
-Each back theme must have
+---
 
-```
-base.html
-login.html
-register.html
-unconfirmed.html
-```
+## 📸 See it in Action
 
-- info.json
+### Admin Dashboard
+![Admin Dashboard](https://github.com/shopyo/pythoncms/raw/main/assets/dashboard_preview.png)
 
-```json
-{
-	"author": "ARJ",
-	"version": "1.0.20000000000003"
-}
-```
+### Page Editor
+![Page Editor](https://github.com/shopyo/pythoncms/raw/main/assets/editor_preview.png)
 
-## Info json
+### Website Frontend
+![Website Frontend](https://github.com/shopyo/pythoncms/raw/main/assets/frontend_preview.png)
 
-```
-{
-	"display_string": "Admin",
-	"type": "show", // hidden if hide
-	"icons":{
-		"fa": "fas fa-user-lock", // set according to ACTIVE_ICONSET
-		"boxicons": "",           // set according to ACTIVE_ICONSET
-		"file": "icon.svg" // if present, will be used and searched for
-						   // in module/static. Make sure to shopyo collecstatic in production
-	},
-	"url_prefix": "/appadmin",
-	"menu": {
-		"list users":"/", // url-prefix will be concatenated with it for sub menus.
-		"add user": "/add",
-		"roles":"/roles"
-	},
-	"menu-type": "show-menu", // or no-menu. Expects menu key if show-menu.
-	"module_name": "appadmin",
-	"author": {
-		"name":"Abdur-Rahmaan Janhangeer",
-		"website":"https://www.pythonkitchen.com/about-me/",
-		"mail":"arj.python@gmail.com"
-		}
-}
-```
-## Changelog
+---
+
+## 🛠️ Local Development
+
+If you want to contribute to the core or customize the engine:
+
+1. **Clone and Install:**
+   ```bash
+   python -m pip install -e .
+   ```
+
+2. **Initialize:**
+   ```bash
+   cd pythoncms
+   shopyo initialise
+   flask --debug run
+   ```
+
+3. **Database Migrations:**
+   ```bash
+   flask db migrate
+   flask db upgrade
+   ```
+
+---
+
+## 🎨 Themes & Customization
+
+Themes are located at `/static/themes/`.
+
+### Front Themes
+Must include `index.html`, `contact.html`, and `page.html`.
+
+### Back Themes
+Must include `base.html`, `login.html`, `register.html`, and `unconfirmed.html`.
+
+---
+
+## 📄 License & Community
+
+- **License:** MIT
+- **Discord:** [Join our community](https://discord.com/invite/k37Ef6w)
+- **Issues:** [Report a bug](https://github.com/shopyo/pythoncms/issues)
 
-1.2.0
+---
 
-- Tiny MCE configured
-- start command
+*Powered by the Shopyo engine.*

pythoncms/__main__.py

@@ -0,0 +1,4 @@
+from .cli import cli
+
+if __name__ == "__main__":
+    cli()