quickscale-cli 0.59.0__tar.gz → 0.61.0__tar.gz

{quickscale_cli-0.59.0 → quickscale_cli-0.61.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: quickscale-cli
-Version: 0.59.0
+Version: 0.61.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.59.0,<0.60.0)
+Requires-Dist: quickscale-core (>=0.61.0,<0.62.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,14 +53,14 @@ 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
 
@@ -81,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`
@@ -95,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.
 
@@ -113,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.
 
@@ -140,31 +143,31 @@ See [competitive_analysis.md](./docs/overview/competitive_analysis.md) for detai
 
 # Create your first project
 quickscale init myapp
-
-# Start developing
 cd myapp
-poetry install
-poetry run python manage.py migrate
-poetry run python manage.py runserver
-```
 
-**That's it!** Visit http://localhost:8000 to see your new Django project.
+# Or choose a specific theme (v0.61.0+)
+# quickscale init myapp --theme starter_html  # Default HTML theme
+# quickscale init myapp --theme starter_htmx  # HTMX theme (coming in v0.67.0)
+# quickscale init myapp --theme starter_react # React theme (coming in v0.68.0)
+```
 
-### Development Workflow with Docker
+**Choose your development workflow:**
 
-QuickScale includes convenient CLI commands for Docker-based development:
+### Option 1: Docker (Recommended for production parity)
 
 ```bash
 # Start all services (web + database)
 quickscale up
 
-# View logs
-quickscale logs -f web
-
-# Run Django commands
+# Run migrations
 quickscale manage migrate
+
+# Create superuser
 quickscale manage createsuperuser
 
+# View logs
+quickscale logs -f web
+
 # Open a shell in the container
 quickscale shell
 
@@ -172,6 +175,23 @@ quickscale shell
 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
+```
+
+**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).
 
 ## Learn More

{quickscale_cli-0.59.0 → quickscale_cli-0.61.0}/README.md

@@ -27,14 +27,14 @@ 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
 
@@ -55,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`
@@ -69,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.
 
@@ -87,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.
 
@@ -114,31 +117,31 @@ See [competitive_analysis.md](./docs/overview/competitive_analysis.md) for detai
 
 # Create your first project
 quickscale init myapp
-
-# Start developing
 cd myapp
-poetry install
-poetry run python manage.py migrate
-poetry run python manage.py runserver
-```
 
-**That's it!** Visit http://localhost:8000 to see your new Django project.
+# Or choose a specific theme (v0.61.0+)
+# quickscale init myapp --theme starter_html  # Default HTML theme
+# quickscale init myapp --theme starter_htmx  # HTMX theme (coming in v0.67.0)
+# quickscale init myapp --theme starter_react # React theme (coming in v0.68.0)
+```
 
-### Development Workflow with Docker
+**Choose your development workflow:**
 
-QuickScale includes convenient CLI commands for Docker-based development:
+### Option 1: Docker (Recommended for production parity)
 
 ```bash
 # Start all services (web + database)
 quickscale up
 
-# View logs
-quickscale logs -f web
-
-# Run Django commands
+# Run migrations
 quickscale manage migrate
+
+# Create superuser
 quickscale manage createsuperuser
 
+# View logs
+quickscale logs -f web
+
 # Open a shell in the container
 quickscale shell
 
@@ -146,6 +149,23 @@ quickscale shell
 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
+```
+
+**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).
 
 ## Learn More

{quickscale_cli-0.59.0 → quickscale_cli-0.61.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quickscale-cli"
-version = "0.59.0"
+version = "0.61.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.59.0"
+quickscale-core = "^0.61.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4.0"

{quickscale_cli-0.59.0 → quickscale_cli-0.61.0}/src/quickscale_cli/_version.py

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