quickscale-cli 0.58.0__tar.gz → 0.60.0__tar.gz

{quickscale_cli-0.58.0 → quickscale_cli-0.60.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: quickscale-cli
-Version: 0.58.0
+Version: 0.60.0
 Summary: Command-line interface for QuickScale Django project generator
 Home-page: https://github.com/Experto-AI/quickscale
 License: Apache-2.0
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: click (>=8.1.0,<9.0.0)
-Requires-Dist: quickscale-core (>=0.58.0,<0.59.0)
+Requires-Dist: quickscale-core (>=0.60.0,<0.61.0)
 Project-URL: Documentation, https://github.com/Experto-AI/quickscale/tree/main/docs
 Project-URL: Repository, https://github.com/Experto-AI/quickscale
 Description-Content-Type: text/markdown
@@ -53,20 +53,21 @@ QuickScale is a **composable Django framework** for building client SaaS applica
 
 ## What is QuickScale?
 
-QuickScale is a **composable Django framework** designed for **solo developers and development agencies** who build multiple client SaaS applications. It provides a stable foundation with reusable components, enabling you to:
+QuickScale is a **Django project generator** that creates production-ready SaaS applications with one command. Designed for **solo developers and development agencies**, it gives you:
 
-- **Build once, reuse everywhere**: Create modules and themes that work across all your client projects
-- **Maintain commercial flexibility**: Keep core components open source while offering premium modules/themes via subscriptions
-- **Scale your development business**: Standardize your tech stack and accelerate client project delivery
-- **Build a community ecosystem**: Share and monetize your extensions while benefiting from community contributions
+- **Production-ready foundations**: Docker, PostgreSQL, testing, CI/CD, and security out-of-the-box
+- **One-command deployment**: Deploy to Railway with `quickscale deploy railway`
+- **Full ownership**: Generated projects are 100% yours to customize—no vendor lock-in
+- **Standardized stack**: Build multiple client projects faster with consistent best practices
 
-🧭 **Evolution Snapshot**: QuickScale intentionally ships as a personal toolkit today and only grows into a community platform when real demand emerges. Catch the full story in the [evolution overview](./docs/overview/quickscale.md#evolution-strategy-personal-toolkit-first).
+🧭 **Future Vision**: QuickScale will evolve to support reusable modules and themes. Today it's a personal toolkit; tomorrow it becomes a community platform when demand emerges. [Read the full evolution strategy](./docs/overview/quickscale.md#evolution-strategy-personal-toolkit-first).
 
 ## Documentation Guide
 
 **Start here for your needs:**
 - 📖 **New user?** You're in the right place. This README shows you what QuickScale is and how to get started.
 - 🔧 **Need commands?** See [user_manual.md](./docs/technical/user_manual.md) for all commands and workflows
+- 🚀 **Deploying to Railway?** See [railway.md](./docs/deployment/railway.md) for Railway deployment guide
 - 📋 **Planning a feature?** Check [decisions.md](./docs/technical/decisions.md) for the authoritative MVP scope and technical rules
 - 🗓️ **Timeline & tasks?** See [roadmap.md](./docs/technical/roadmap.md)
 - 🏗️ **Project structure?** See [scaffolding.md](./docs/technical/scaffolding.md) for complete directory layouts
@@ -80,11 +81,13 @@ QuickScale is a **composable Django framework** designed for **solo developers a
 See [decisions.md - Glossary section](./docs/technical/decisions.md#document-responsibilities-short) for complete terminology and Single Source of Truth reference
 
 
-### Primary Use Cases:
-- **Solo Developer**: Build client projects faster with reusable components you maintain
-- **Development Agency**: Standardize your tech stack across multiple client engagements  
+### Primary Use Cases (MVP):
+- **Solo Developer**: Build client projects faster with production-ready foundations
+- **Development Agency**: Standardize your tech stack across client engagements
+
+### Future Use Cases (Post-MVP):
 - **Commercial Extension Developer**: Create and sell premium modules/themes
-- **Open Source Contributor**: Extend the ecosystem with new modules and themes
+- **Open Source Contributor**: Extend the ecosystem with modules and themes
 
 ### Development Flow (MVP)
 1. `quickscale init myapp`
@@ -94,7 +97,7 @@ See [decisions.md - Glossary section](./docs/technical/decisions.md#document-res
 2. Add your custom Django apps and features
 3. Adopt optional inheritance or module extraction patterns only when you embed the core; the rules and best practices stay centralized in `DECISIONS.md`
 4. Build your unique client application
-5. Deploy using standard Django deployment patterns
+5. Deploy to Railway with `quickscale deploy railway` (or use standard Django deployment)
 
 ℹ️ QuickScale's MVP centers on the personal toolkit workflow. Extraction patterns, module packaging, and subtree helper command plans stay documented in `docs/technical/decisions.md` so this README can stay concise.
 
@@ -112,17 +115,18 @@ Running `quickscale init myapp` generates a **production-ready Django project**
 - ✅ **CI/CD** pipeline (GitHub Actions)
 - ✅ **Code quality** hooks (ruff format + ruff check)
 - ✅ **Poetry** for dependency management
+- ✅ **One-Command Deployment**: Deploy to Railway with `quickscale deploy railway` - fully automated setup
 
 **See the complete project structure:** [scaffolding.md - Generated Project Output](./docs/technical/scaffolding.md#5-generated-project-output)
 
 The generated project is **yours to own and modify** - no vendor lock-in, just Django best practices.
 
-## Why QuickScale?
+## Why QuickScale vs. Alternatives?
 
-✅ **Production-ready from day one** - Docker, PostgreSQL, pytest, CI/CD, security best practices
-✅ **Built on Django** - No magic, just excellent Django patterns and battle-tested packages
-✅ **Shared improvements** - Security fixes and updates flow across all your projects via git subtree
-✅ **Full ownership** - Generated projects are 100% yours, no vendor lock-in
+✅ **Faster than Cookiecutter** - One command vs. 30+ interactive prompts
+✅ **More flexible than SaaS Pegasus** - Open source with full code ownership ($0 vs. $349+)
+✅ **Simpler than building from scratch** - Production-ready in 5 minutes vs. days of setup
+✅ **Railway deployment automation** - Competitors require manual platform configuration
 
 **QuickScale is a development accelerator**, not a complete solution. You start with production-ready foundations and build your unique client application on top.
 
@@ -139,15 +143,49 @@ See [competitive_analysis.md](./docs/overview/competitive_analysis.md) for detai
 
 # Create your first project
 quickscale init myapp
-
-# Start developing
 cd myapp
+```
+
+**Choose your development workflow:**
+
+### Option 1: Docker (Recommended for production parity)
+
+```bash
+# Start all services (web + database)
+quickscale up
+
+# Run migrations
+quickscale manage migrate
+
+# Create superuser
+quickscale manage createsuperuser
+
+# View logs
+quickscale logs -f web
+
+# Open a shell in the container
+quickscale shell
+
+# Stop services
+quickscale down
+```
+
+**Visit http://localhost:8000** - Your app is running in Docker with PostgreSQL!
+
+### Option 2: Native Poetry (Simpler for quick testing)
+
+```bash
+# Install dependencies
 poetry install
+
+# Run migrations
 poetry run python manage.py migrate
+
+# Start development server
 poetry run python manage.py runserver
 ```
 
-**That's it!** Visit http://localhost:8000 to see your new Django project.
+**Visit http://localhost:8000** - Your app is running natively!
 
 **For complete command reference and workflows**, see the [user_manual.md](./docs/technical/user_manual.md).
 

{quickscale_cli-0.58.0 → quickscale_cli-0.60.0}/README.md

@@ -27,20 +27,21 @@ QuickScale is a **composable Django framework** for building client SaaS applica
 
 ## What is QuickScale?
 
-QuickScale is a **composable Django framework** designed for **solo developers and development agencies** who build multiple client SaaS applications. It provides a stable foundation with reusable components, enabling you to:
+QuickScale is a **Django project generator** that creates production-ready SaaS applications with one command. Designed for **solo developers and development agencies**, it gives you:
 
-- **Build once, reuse everywhere**: Create modules and themes that work across all your client projects
-- **Maintain commercial flexibility**: Keep core components open source while offering premium modules/themes via subscriptions
-- **Scale your development business**: Standardize your tech stack and accelerate client project delivery
-- **Build a community ecosystem**: Share and monetize your extensions while benefiting from community contributions
+- **Production-ready foundations**: Docker, PostgreSQL, testing, CI/CD, and security out-of-the-box
+- **One-command deployment**: Deploy to Railway with `quickscale deploy railway`
+- **Full ownership**: Generated projects are 100% yours to customize—no vendor lock-in
+- **Standardized stack**: Build multiple client projects faster with consistent best practices
 
-🧭 **Evolution Snapshot**: QuickScale intentionally ships as a personal toolkit today and only grows into a community platform when real demand emerges. Catch the full story in the [evolution overview](./docs/overview/quickscale.md#evolution-strategy-personal-toolkit-first).
+🧭 **Future Vision**: QuickScale will evolve to support reusable modules and themes. Today it's a personal toolkit; tomorrow it becomes a community platform when demand emerges. [Read the full evolution strategy](./docs/overview/quickscale.md#evolution-strategy-personal-toolkit-first).
 
 ## Documentation Guide
 
 **Start here for your needs:**
 - 📖 **New user?** You're in the right place. This README shows you what QuickScale is and how to get started.
 - 🔧 **Need commands?** See [user_manual.md](./docs/technical/user_manual.md) for all commands and workflows
+- 🚀 **Deploying to Railway?** See [railway.md](./docs/deployment/railway.md) for Railway deployment guide
 - 📋 **Planning a feature?** Check [decisions.md](./docs/technical/decisions.md) for the authoritative MVP scope and technical rules
 - 🗓️ **Timeline & tasks?** See [roadmap.md](./docs/technical/roadmap.md)
 - 🏗️ **Project structure?** See [scaffolding.md](./docs/technical/scaffolding.md) for complete directory layouts
@@ -54,11 +55,13 @@ QuickScale is a **composable Django framework** designed for **solo developers a
 See [decisions.md - Glossary section](./docs/technical/decisions.md#document-responsibilities-short) for complete terminology and Single Source of Truth reference
 
 
-### Primary Use Cases:
-- **Solo Developer**: Build client projects faster with reusable components you maintain
-- **Development Agency**: Standardize your tech stack across multiple client engagements  
+### Primary Use Cases (MVP):
+- **Solo Developer**: Build client projects faster with production-ready foundations
+- **Development Agency**: Standardize your tech stack across client engagements
+
+### Future Use Cases (Post-MVP):
 - **Commercial Extension Developer**: Create and sell premium modules/themes
-- **Open Source Contributor**: Extend the ecosystem with new modules and themes
+- **Open Source Contributor**: Extend the ecosystem with modules and themes
 
 ### Development Flow (MVP)
 1. `quickscale init myapp`
@@ -68,7 +71,7 @@ See [decisions.md - Glossary section](./docs/technical/decisions.md#document-res
 2. Add your custom Django apps and features
 3. Adopt optional inheritance or module extraction patterns only when you embed the core; the rules and best practices stay centralized in `DECISIONS.md`
 4. Build your unique client application
-5. Deploy using standard Django deployment patterns
+5. Deploy to Railway with `quickscale deploy railway` (or use standard Django deployment)
 
 ℹ️ QuickScale's MVP centers on the personal toolkit workflow. Extraction patterns, module packaging, and subtree helper command plans stay documented in `docs/technical/decisions.md` so this README can stay concise.
 
@@ -86,17 +89,18 @@ Running `quickscale init myapp` generates a **production-ready Django project**
 - ✅ **CI/CD** pipeline (GitHub Actions)
 - ✅ **Code quality** hooks (ruff format + ruff check)
 - ✅ **Poetry** for dependency management
+- ✅ **One-Command Deployment**: Deploy to Railway with `quickscale deploy railway` - fully automated setup
 
 **See the complete project structure:** [scaffolding.md - Generated Project Output](./docs/technical/scaffolding.md#5-generated-project-output)
 
 The generated project is **yours to own and modify** - no vendor lock-in, just Django best practices.
 
-## Why QuickScale?
+## Why QuickScale vs. Alternatives?
 
-✅ **Production-ready from day one** - Docker, PostgreSQL, pytest, CI/CD, security best practices
-✅ **Built on Django** - No magic, just excellent Django patterns and battle-tested packages
-✅ **Shared improvements** - Security fixes and updates flow across all your projects via git subtree
-✅ **Full ownership** - Generated projects are 100% yours, no vendor lock-in
+✅ **Faster than Cookiecutter** - One command vs. 30+ interactive prompts
+✅ **More flexible than SaaS Pegasus** - Open source with full code ownership ($0 vs. $349+)
+✅ **Simpler than building from scratch** - Production-ready in 5 minutes vs. days of setup
+✅ **Railway deployment automation** - Competitors require manual platform configuration
 
 **QuickScale is a development accelerator**, not a complete solution. You start with production-ready foundations and build your unique client application on top.
 
@@ -113,15 +117,49 @@ See [competitive_analysis.md](./docs/overview/competitive_analysis.md) for detai
 
 # Create your first project
 quickscale init myapp
-
-# Start developing
 cd myapp
+```
+
+**Choose your development workflow:**
+
+### Option 1: Docker (Recommended for production parity)
+
+```bash
+# Start all services (web + database)
+quickscale up
+
+# Run migrations
+quickscale manage migrate
+
+# Create superuser
+quickscale manage createsuperuser
+
+# View logs
+quickscale logs -f web
+
+# Open a shell in the container
+quickscale shell
+
+# Stop services
+quickscale down
+```
+
+**Visit http://localhost:8000** - Your app is running in Docker with PostgreSQL!
+
+### Option 2: Native Poetry (Simpler for quick testing)
+
+```bash
+# Install dependencies
 poetry install
+
+# Run migrations
 poetry run python manage.py migrate
+
+# Start development server
 poetry run python manage.py runserver
 ```
 
-**That's it!** Visit http://localhost:8000 to see your new Django project.
+**Visit http://localhost:8000** - Your app is running natively!
 
 **For complete command reference and workflows**, see the [user_manual.md](./docs/technical/user_manual.md).
 

{quickscale_cli-0.58.0 → quickscale_cli-0.60.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quickscale-cli"
-version = "0.58.0"
+version = "0.60.0"
 description = "Command-line interface for QuickScale Django project generator"
 authors = ["Experto AI <victor@experto.ai>"]
 license = "Apache-2.0"
@@ -26,7 +26,7 @@ packages = [{include = "quickscale_cli", from = "src"}]
 [tool.poetry.dependencies]
 python = "^3.10"
 click = "^8.1.0"
-quickscale-core = "^0.58.0"
+quickscale-core = "^0.60.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4.0"
@@ -52,6 +52,7 @@ addopts = [
     "--cov=quickscale_cli",
     "--cov-report=term-missing",
     "--cov-report=html",
+    "-m", "not e2e",  # Skip E2E tests by default (run with: pytest -m e2e)
 ]
 
 [tool.ruff]

{quickscale_cli-0.58.0 → quickscale_cli-0.60.0}/src/quickscale_cli/_version.py

@@ -1,2 +1,2 @@
 # Auto-generated by scripts/version_tool.sh
-__version__ = "0.58.0"
+__version__ = "0.60.0"

quickscale_cli-0.60.0/src/quickscale_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands package for QuickScale."""