# Saaspegasus > This is the full developer documentation for SaaS Pegasus ## Pages - [Docs 7 Documentation](docs-7-documentation.md) - [SaaS Pegasus Documentation](saas-pegasus-documentation.md): Everything you need to know about setting up and configuring Pegasus for your project. - [Getting Started](getting-started.md): Complete setup guide for Pegasus projects with Docker or native Python, including database configuration and post-ins... - [or if using pip tools](or-if-using-pip-tools.md): pip install -r dev-requirements.txt - [or with normal venv](or-with-normal-venv.md): python ./manage.py makemigrations - [or with normal venv](or-with-normal-venv-2.md): python ./manage.py migrate - [or with normal venv](or-with-normal-venv-3.md): python ./manage.py runserver - [Working with Python Packages (uv)](working-with-python-packages-uv.md): Fast Python package management with uv using pyproject.toml and uv.lock files for adding, removing, and upgrading dep... - [native version](native-version.md): uv add - [docker version](docker-version.md): make uv add - [native version - update the lockfile](native-version-update-the-lockfile.md): uv lock --upgrade-package - [native version - update the lockfile and sync the virtual environment](native-version-update-the-lockfile-and-sync-the-virtual-environment.md): uv sync --upgrade-package - [docker version](docker-version-2.md): make uv "lock --upgrade-package wagtail" - [native version - update the lockfile](native-version-update-the-lockfile-2.md): uv lock --upgrade - [native version - update the lockfile and sync the virtual environment](native-version-update-the-lockfile-and-sync-the-virtual-environment-2.md): uv sync --upgrade - [docker version](docker-version-3.md): make uv "lock --upgrade" - [Pegasus's Code Structure](pegasuss-code-structure.md): Understand Pegasus project organization with apps, static files, templates, and code formatting using pre-commit hook... - [run all hooks against currently staged files](run-all-hooks-against-currently-staged-files.md): pre-commit run - [run all the hooks against all the files. This is a useful invocation if you are using pre-commit in CI.](run-all-the-hooks-against-all-the-files-this-is-a-useful-invocation-if-you-are-u.md): pre-commit run --all-files - [Settings and Configuration](settings-and-configuration.md): Configure Django settings, environment variables, email providers, social authentication, Stripe payments, and produc... - [APIs](apis.md): Django REST Framework APIs with auto-generated OpenAPI schemas, TypeScript clients, and authentication support for bu... - [Async and Websocket Support](async-and-websocket-support.md): Enable asynchronous Django views and real-time websockets using Daphne, Uvicorn, and Django Channels for modern web a... - [Celery](celery.md): Set up Celery distributed task queues with Redis for background tasks, scheduled jobs, and async processing in Pegasu... - [Alongside the Celery worker, you can run Celery Beat](alongside-the-celery-worker-you-can-run-celery-beat.md): uv run celery -A {{ project_name }} worker -l info --beat - [AS a dedicated process](as-a-dedicated-process.md): uv run celery -A {{ project_name }} beat -l info - [Cookbooks](cookbooks.md): Step-by-step guides for Django admin setup, migrating from pip-tools to uv, enabling code formatting, and common deve... - [Customizations](customizations.md): Customize landing pages, navigation, styles, and JavaScript in your Pegasus application with popular CSS frameworks. - [Using Docker in Development](using-docker-in-development.md): Set up Django development environment with Docker Compose including PostgreSQL, Redis, Celery, and debugging configur... - [Feature Flags](feature-flags.md): Implement feature flags with Django Waffle to control feature rollouts, A/B testing, and user-specific or team-based ... - [Forms](forms.md): Render Django forms with CSS framework integration, dynamic Alpine.js functionality, and custom template tags for bet... - [GitHub Integration](github-integration.md): Integrate projects with GitHub using OAuth or personal access tokens for automated updates, pull requests, and versio... - [Using Github Actions](using-github-actions.md): Automate Django testing and front-end builds with GitHub Actions CI/CD workflows for continuous integration. - [Internationalization](internationalization.md): Add multi-language support and timezone handling to Django applications with translation files, locale management, an... - [Project/Page Metadata and SEO](projectpage-metadata-and-seo.md): Configure SEO metadata, page titles, social sharing tags, and XML sitemaps for better search engine optimization and ... - [E-Commerce / Payments](e-commerce-payments.md): Build digital storefronts with Stripe integration for one-time and recurring payments, product management, and purcha... - [Version History and Release Notes](version-history-and-release-notes.md): Complete changelog and version history for SaaS Pegasus Django boilerplate with detailed feature updates and migratio... - [add an OPENAI_API_KEY setting, in case it was referenced elsewhere in your code](add-an-openai-api-key-setting-in-case-it-was-referenced-elsewhere-in-your-code.md): OPENAI_API_KEY = env("OPENAI_API_KEY", default="") - [modify the image/chat settings to use the same openai key instead of reading from new environment variables](modify-the-imagechat-settings-to-use-the-same-openai-key-instead-of-reading-from.md): AI_IMAGES_OPENAI_API_KEY = OPENAI_API_KEY - [or with uv](or-with-uv.md): uv run ruff check --fix - [install node/npm](install-nodenpm.md): RUN curl -fsSL | \ - [Subscriptions](subscriptions.md): Implement SaaS subscriptions with Stripe billing, pricing tables, webhooks, customer portals, and per-seat or usage-b... - [Using Teams](using-teams.md): Build multi-tenant applications with team-based data models, role-based permissions, and collaborative user managemen... - [import the and use function you created in step 1](import-the-and-use-function-you-created-in-step-1.md): from .roles import is_admin, is_member, is_moderator - [Information about Templates](information-about-templates.md): Overview of Django template structure and organization in Pegasus projects for building consistent user interfaces. - [Upgrading and Changing your Project Settings](upgrading-and-changing-your-project-settings.md): Upgrade Pegasus projects to new versions using GitHub integration, git branches, or patch files with conflict resolut... - [Wagtail CMS](wagtail-cms.md): Add content management system capabilities with Wagtail CMS for blogs, marketing pages, and rich editorial experiences. - [AI Integrations for Development](ai-integrations-for-development.md): Set up AI-powered coding assistants with Cursor, Claude Code, and Junie, including rules files and MCP tools for enha... - [Image Models](image-models.md): Generate images with AI models including DALL-E-2, DALL-E-3, and Stability AI using OpenAI and Stability AI API keys ... - [LLMs and Chat](llms-and-chat.md): Integrate LLM chat interfaces with OpenAI GPT models, Claude, or local models using Ollama. Supports streaming, async... - [Using Digital Ocean Spaces for Django Media (in addition to AWS services)](using-digital-ocean-spaces-for-django-media-in-addition-to-aws-services.md): Configure Digital Ocean Spaces for Django media storage while using AWS SES for email, with detailed deployment setti... - [Automating Deployment to Cloud Run using GitHub Actions](automating-deployment-to-cloud-run-using-github-actions.md): Automate Pegasus deployment to Google Cloud Run using GitHub Actions with service accounts, Artifact Registry, and CI... - [Set your project ID (replace "replace-with-your-project-id" with your actual project ID)](set-your-project-id-replace-replace-with-your-project-id-with-your-actual-projec.md): export PROJECT_ID="replace-with-your-project-id" - [Set the deployment service account email and the service account email that will run the Cloud Run application](set-the-deployment-service-account-email-and-the-service-account-email-that-will.md): export DEPLOY_SERVICE_NAME="cloud-run-deployer" - [Set the service account that will run the Cloud Run application](set-the-service-account-that-will-run-the-cloud-run-application.md): export SERVICE_ACCOUNT="cloud-run-app@$PROJECT_ID.iam.gserviceaccount.com""cloud-run-deployer@$PROJECT_ID.iam.gservic... - [Create the deployment service account](create-the-deployment-service-account.md): gcloud iam service-accounts create $DEPLOY_SERVICE_NAME \ - [Grant Cloud Run Admin role (allows deploying to Cloud Run)](grant-cloud-run-admin-role-allows-deploying-to-cloud-run.md): gcloud projects add-iam-policy-binding "$PROJECT_ID" \ - [Grant Storage Admin role (to push Docker images to Artifact Registry)](grant-storage-admin-role-to-push-docker-images-to-artifact-registry.md): gcloud projects add-iam-policy-binding "$PROJECT_ID" \ - [Grant Service Account User role (to allow the deployment service account to impersonate the service account that runs the Cloud Run application)](grant-service-account-user-role-to-allow-the-deployment-service-account-to-imper.md) - [Only for deploying cloud run](only-for-deploying-cloud-run.md): gcloud iam service-accounts add-iam-policy-binding $SERVICE_ACCOUNT \ - [Create and download the service account key](create-and-download-the-service-account-key.md): gcloud iam service-accounts keys create ~/cloud-run-deployer-key.json \ - [Bootstrap](bootstrap.md): Customize Bootstrap 5 themes in Pegasus with Sass variables, JavaScript integration, and Material Kit alternatives fo... - [Bulma](bulma.md): Customize Bulma CSS framework using Sass variables for colors, typography, and styling in your Pegasus application. - [CSS File Structure](css-file-structure.md): Understand Pegasus CSS file organization with framework-independent styles and framework-specific overrides compiled ... - [The Material Theme (deprecated)](the-material-theme-deprecated.md): Legacy Material Design theme based on Creative Tim's Material Kit and Dashboard, now deprecated with maintenance-only... - [Choosing a CSS Theme](choosing-a-css-theme.md): Compare TailwindCSS, Bootstrap, Bulma, and Material Design themes with screenshots, features, and recommendations for... - [Pegasus CSS](pegasus-css.md): Cross-framework CSS classes with pg- prefixes for consistent styling across Bootstrap, TailwindCSS, and Bulma using S... - [Tailwind CSS](tailwind-css.md): Build modern UIs with TailwindCSS v4, DaisyUI components, shadcn/ui integration, dark mode themes, and Flowbite styli... - [Digital Ocean](digital-ocean.md): Deploy Pegasus apps to Digital Ocean App Platform using Docker containers with PostgreSQL, Redis, and Celery support ... - [Fly.io](flyio.md): Container-based Django deployment to Fly.io with PostgreSQL, Upstash Redis, and automated database migrations using D... - [Google Cloud](google-cloud.md): Deploy Pegasus projects to Google Cloud Run with Cloud SQL PostgreSQL, Redis, Secret Manager, and Google Cloud Storag... - [Heroku](heroku.md): Deploy Pegasus apps to Heroku using Python buildpacks or Docker containers with PostgreSQL, Redis, and Celery for sca... - [Kamal (Deploy to any VPS)](kamal-deploy-to-any-vps.md): Deploy Pegasus to any Linux VPS using Kamal with automated SSL certificates, load balancing, and PostgreSQL database ... - [rebuild the PostgreSQL container](rebuild-the-postgresql-container.md): kamal accessory reboot postgres - [rebuild the Redis container](rebuild-the-redis-container.md): kamal accessory reboot redis - [build the proxy container (if it didn't succeed the first time)](build-the-proxy-container-if-it-didnt-succeed-the-first-time.md): kamal proxy boot - [deploy the app](deploy-the-app.md): kamal deploy - [Deployment Overview](deployment-overview.md): Compare Django deployment options including VPS, PaaS platforms like Heroku and Render, Docker containers, and Kubern... - [Production checklist](production-checklist.md): Essential Pegasus production setup checklist covering security settings, email configuration, static files, media sto... - [Render](render.md): Deploy Pegasus applications to Render platform with PostgreSQL, Redis, automatic builds, and Celery worker support fo... - [exit on error](exit-on-error.md): set -o errexit - [Troubleshooting](troubleshooting.md): Resolve common Django deployment issues including 400 Bad Request errors, broken styles, API client problems, and mis... - [Standalone React Front End](standalone-react-front-end.md): Build decoupled React single-page applications with Vite, session authentication, API integration, and deployment to ... - [Front End Design Patterns](front-end-design-patterns.md): JavaScript design patterns for Pegasus projects including site-wide libraries, npm package integration, and SiteJS ut... - [Migrating from Webpack to Vite](migrating-from-webpack-to-vite.md): Step-by-step guide to migrate Pegasus projects from Webpack to Vite bundler with React JSX file extensions and templa... - [Front End Overview](front-end-overview.md): Modern JavaScript build pipeline with Vite or Webpack, TypeScript support, CSS compilation, and hybrid Django templat... - [Troubleshooting](troubleshooting-2.md): Fix Docker cross-platform file watching issues with webpack polling configuration for Windows and other development e... - [Vite-Specific Instructions](vite-specific-instructions.md): Configure Vite with django-vite for fast development server, Hot Module Replacement, and seamless Django template int... - [Webpack-Specific Instructions](webpack-specific-instructions.md): Use Webpack for Django front-end builds with dev-watch mode, bundle compilation, and static file management for JavaS... - [How to connect a marketplace app to a Pegasus project](how-to-connect-a-marketplace-app-to-a-pegasus-project.md): Connect marketplace apps like Scriv to Pegasus projects via GitHub integration with proper configuration matching and... - [Working with Scriv](working-with-scriv.md): Deploy and customize Scriv chat widget application with Fly.io integration, Docker configuration, and npm package pub... - [Working with Python Packages (pip-tools)](working-with-python-packages-pip-tools.md): Manage Python dependencies with pip-tools using requirements.in files, pip-compile commands, and Docker container reb... - [native version](native-version-2.md): pip-compile requirements/requirements.in - [docker version](docker-version-4.md): make pip-compile - [native version](native-version-3.md): pip-compile --upgrade-package django requirements/requirements.in - [docker version](docker-version-5.md): make pip-complie ARGS="--upgrade-package django" - [native version](native-version-4.md): pip-compile --upgrade requirements/requirements.in - [docker version](docker-version-6.md): make pip-compile ARGS="--upgrade" - [Python Environment Setup](python-environment-setup.md): Set up Pegasus development environments using Docker, uv package manager, virtual environments, or IDE integration fo... - [Saaspegasus Documentation](saaspegasus-documentation.md) - [SaaS Pegasus Documentation](saas-pegasus-documentation-2.md): Everything you need to know about setting up and configuring Pegasus for your project. - [Getting Started](getting-started-2.md): Complete setup guide for Pegasus projects with Docker or native Python, including database configuration and post-ins... - [or if using pip tools](or-if-using-pip-tools-2.md): pip install -r dev-requirements.txt - [or with normal venv](or-with-normal-venv-2.md): python ./manage.py makemigrations - [or with normal venv](or-with-normal-venv-2-2.md): python ./manage.py migrate - [or with normal venv](or-with-normal-venv-3-2.md): python ./manage.py runserver - [Working with Python Packages (uv)](working-with-python-packages-uv-2.md): Fast Python package management with uv using pyproject.toml and uv.lock files for adding, removing, and upgrading dep... - [native version](native-version-2.md): uv add - [docker version](docker-version-2.md): make uv add - [native version - update the lockfile](native-version-update-the-lockfile-2.md): uv lock --upgrade-package - [native version - update the lockfile and sync the virtual environment](native-version-update-the-lockfile-and-sync-the-virtual-environment-2.md): uv sync --upgrade-package - [docker version](docker-version-2-2.md): make uv "lock --upgrade-package wagtail" - [native version - update the lockfile](native-version-update-the-lockfile-2-2.md): uv lock --upgrade - [native version - update the lockfile and sync the virtual environment](native-version-update-the-lockfile-and-sync-the-virtual-environment-2-2.md): uv sync --upgrade - [docker version](docker-version-3-2.md): make uv "lock --upgrade" - [Pegasus's Code Structure](pegasuss-code-structure-2.md): Understand Pegasus project organization with apps, static files, templates, and code formatting using pre-commit hook... - [run all hooks against currently staged files](run-all-hooks-against-currently-staged-files-2.md): pre-commit run - [run all the hooks against all the files. This is a useful invocation if you are using pre-commit in CI.](run-all-the-hooks-against-all-the-files-this-is-a-useful-invocation-if-you-are-u-2.md): pre-commit run --all-files - [Settings and Configuration](settings-and-configuration-2.md): Configure Django settings, environment variables, email providers, social authentication, Stripe payments, and produc... - [APIs](apis-2.md): Django REST Framework APIs with auto-generated OpenAPI schemas, TypeScript clients, and authentication support for bu... - [Async and Websocket Support](async-and-websocket-support-2.md): Enable asynchronous Django views and real-time websockets using Daphne, Uvicorn, and Django Channels for modern web a... - [Celery](celery-2.md): Set up Celery distributed task queues with Redis for background tasks, scheduled jobs, and async processing in Pegasu... - [Alongside the Celery worker, you can run Celery Beat](alongside-the-celery-worker-you-can-run-celery-beat-2.md): uv run celery -A {{ project_name }} worker -l info --beat - [AS a dedicated process](as-a-dedicated-process-2.md): uv run celery -A {{ project_name }} beat -l info - [Cookbooks](cookbooks-2.md): Step-by-step guides for Django admin setup, migrating from pip-tools to uv, enabling code formatting, and common deve... - [Customizations](customizations-2.md): Customize landing pages, navigation, styles, and JavaScript in your Pegasus application with popular CSS frameworks. - [Using Docker in Development](using-docker-in-development-2.md): Set up Django development environment with Docker Compose including PostgreSQL, Redis, Celery, and debugging configur... - [Early Access Program](early-access-program.md): How to get early access to new SaaS Pegasus features and development releases. - [Feature Flags](feature-flags-2.md): Implement feature flags with Django Waffle to control feature rollouts, A/B testing, and user-specific or team-based ... - [Forms](forms-2.md): Render Django forms with CSS framework integration, dynamic Alpine.js functionality, and custom template tags for bet... - [GitHub Integration](github-integration-2.md): Integrate projects with GitHub using OAuth or personal access tokens for automated updates, pull requests, and versio... - [Using Github Actions](using-github-actions-2.md): Automate Django testing and front-end builds with GitHub Actions CI/CD workflows for continuous integration. - [Internationalization](internationalization-2.md): Add multi-language support and timezone handling to Django applications with translation files, locale management, an... - [Project/Page Metadata and SEO](projectpage-metadata-and-seo-2.md): Configure SEO metadata, page titles, social sharing tags, and XML sitemaps for better search engine optimization and ... - [E-Commerce / Payments](e-commerce-payments-2.md): Build digital storefronts with Stripe integration for one-time and recurring payments, product management, and purcha... - [Version History and Release Notes](version-history-and-release-notes-2.md): Complete changelog and version history for SaaS Pegasus Django boilerplate with detailed feature updates and migratio... - [add an OPENAI_API_KEY setting, in case it was referenced elsewhere in your code](add-an-openai-api-key-setting-in-case-it-was-referenced-elsewhere-in-your-code-2.md): OPENAI_API_KEY = env("OPENAI_API_KEY", default="") - [modify the image/chat settings to use the same openai key instead of reading from new environment variables](modify-the-imagechat-settings-to-use-the-same-openai-key-instead-of-reading-from-2.md): AI_IMAGES_OPENAI_API_KEY = OPENAI_API_KEY - [or with uv](or-with-uv-2.md): uv run ruff check --fix - [In Development Release Notes](in-development-release-notes.md): Preview of upcoming features and changes in the next SaaS Pegasus release. - [Release Notes History](release-notes-history.md): Historical release notes and changelog for older versions of SaaS Pegasus Django boilerplate. - [install node/npm](install-nodenpm-2.md): RUN curl -fsSL | \ - [Subscriptions](subscriptions-2.md): Implement SaaS subscriptions with Stripe billing, pricing tables, webhooks, customer portals, and per-seat or usage-b... - [Using Teams](using-teams-2.md): Build multi-tenant applications with team-based data models, role-based permissions, and collaborative user managemen... - [import the and use function you created in step 1](import-the-and-use-function-you-created-in-step-1-2.md): from .roles import is_admin, is_member, is_moderator - [Information about Templates](information-about-templates-2.md): Overview of Django template structure and organization in Pegasus projects for building consistent user interfaces. - [Upgrading and Changing your Project Settings](upgrading-and-changing-your-project-settings-2.md): Upgrade Pegasus projects to new versions using GitHub integration, git branches, or patch files with conflict resolut... - [Wagtail CMS](wagtail-cms-2.md): Add content management system capabilities with Wagtail CMS for blogs, marketing pages, and rich editorial experiences. - [AI Integrations for Development](ai-integrations-for-development-2.md): Set up AI-powered coding assistants with Cursor, Claude Code, and Junie, including rules files and MCP tools for enha... - [Image Models](image-models-2.md): Generate images with AI models including DALL-E-2, DALL-E-3, and Stability AI using OpenAI and Stability AI API keys ... - [LLMs and Chat](llms-and-chat-2.md): Integrate LLM chat interfaces with OpenAI GPT models, Claude, or local models using Ollama. Supports streaming, async... - [Using Digital Ocean Spaces for Django Media (in addition to AWS services)](using-digital-ocean-spaces-for-django-media-in-addition-to-aws-services-2.md): Configure Digital Ocean Spaces for Django media storage while using AWS SES for email, with detailed deployment setti... - [Automating Deployment to Cloud Run using GitHub Actions](automating-deployment-to-cloud-run-using-github-actions-2.md): Automate Pegasus deployment to Google Cloud Run using GitHub Actions with service accounts, Artifact Registry, and CI... - [Set your project ID (replace "replace-with-your-project-id" with your actual project ID)](set-your-project-id-replace-replace-with-your-project-id-with-your-actual-projec-2.md): export PROJECT_ID="replace-with-your-project-id" - [Set the deployment service account email and the service account email that will run the Cloud Run application](set-the-deployment-service-account-email-and-the-service-account-email-that-will-2.md): export DEPLOY_SERVICE_NAME="cloud-run-deployer" - [Set the service account that will run the Cloud Run application](set-the-service-account-that-will-run-the-cloud-run-application-2.md): export SERVICE_ACCOUNT="cloud-run-app@$PROJECT_ID.iam.gserviceaccount.com""cloud-run-deployer@$PROJECT_ID.iam.gservic... - [Create the deployment service account](create-the-deployment-service-account-2.md): gcloud iam service-accounts create $DEPLOY_SERVICE_NAME \ - [Grant Cloud Run Admin role (allows deploying to Cloud Run)](grant-cloud-run-admin-role-allows-deploying-to-cloud-run-2.md): gcloud projects add-iam-policy-binding "$PROJECT_ID" \ - [Grant Storage Admin role (to push Docker images to Artifact Registry)](grant-storage-admin-role-to-push-docker-images-to-artifact-registry-2.md): gcloud projects add-iam-policy-binding "$PROJECT_ID" \ - [Grant Service Account User role (to allow the deployment service account to impersonate the service account that runs the Cloud Run application)](grant-service-account-user-role-to-allow-the-deployment-service-account-to-imper-2.md) - [Only for deploying cloud run](only-for-deploying-cloud-run-2.md): gcloud iam service-accounts add-iam-policy-binding $SERVICE_ACCOUNT \ - [Create and download the service account key](create-and-download-the-service-account-key-2.md): gcloud iam service-accounts keys create ~/cloud-run-deployer-key.json \ - [Bootstrap](bootstrap-2.md): Customize Bootstrap 5 themes in Pegasus with Sass variables, JavaScript integration, and Material Kit alternatives fo... - [Bulma](bulma-2.md): Customize Bulma CSS framework using Sass variables for colors, typography, and styling in your Pegasus application. - [CSS File Structure](css-file-structure-2.md): Understand Pegasus CSS file organization with framework-independent styles and framework-specific overrides compiled ... - [The Material Theme (deprecated)](the-material-theme-deprecated-2.md): Legacy Material Design theme based on Creative Tim's Material Kit and Dashboard, now deprecated with maintenance-only... - [Choosing a CSS Theme](choosing-a-css-theme-2.md): Compare TailwindCSS, Bootstrap, Bulma, and Material Design themes with screenshots, features, and recommendations for... - [Pegasus CSS](pegasus-css-2.md): Cross-framework CSS classes with pg- prefixes for consistent styling across Bootstrap, TailwindCSS, and Bulma using S... - [Tailwind CSS](tailwind-css-2.md): Build modern UIs with TailwindCSS v4, DaisyUI components, shadcn/ui integration, dark mode themes, and Flowbite styli... - [Digital Ocean](digital-ocean-2.md): Deploy Pegasus apps to Digital Ocean App Platform using Docker containers with PostgreSQL, Redis, and Celery support ... - [Fly.io](flyio-2.md): Container-based Django deployment to Fly.io with PostgreSQL, Upstash Redis, and automated database migrations using D... - [Google Cloud](google-cloud-2.md): Deploy Pegasus projects to Google Cloud Run with Cloud SQL PostgreSQL, Redis, Secret Manager, and Google Cloud Storag... - [Heroku](heroku-2.md): Deploy Pegasus apps to Heroku using Python buildpacks or Docker containers with PostgreSQL, Redis, and Celery for sca... - [Kamal (Deploy to any VPS)](kamal-deploy-to-any-vps-2.md): Deploy Pegasus to any Linux VPS using Kamal with automated SSL certificates, load balancing, and PostgreSQL database ... - [rebuild the PostgreSQL container](rebuild-the-postgresql-container-2.md): kamal accessory reboot postgres - [rebuild the Redis container](rebuild-the-redis-container-2.md): kamal accessory reboot redis - [build the proxy container (if it didn't succeed the first time)](build-the-proxy-container-if-it-didnt-succeed-the-first-time-2.md): kamal proxy boot - [deploy the app](deploy-the-app-2.md): kamal deploy - [Deployment Overview](deployment-overview-2.md): Compare Django deployment options including VPS, PaaS platforms like Heroku and Render, Docker containers, and Kubern... - [Production checklist](production-checklist-2.md): Essential Pegasus production setup checklist covering security settings, email configuration, static files, media sto... - [Render](render-2.md): Deploy Pegasus applications to Render platform with PostgreSQL, Redis, automatic builds, and Celery worker support fo... - [exit on error](exit-on-error-2.md): set -o errexit - [Troubleshooting](troubleshooting-2.md): Resolve common Django deployment issues including 400 Bad Request errors, broken styles, API client problems, and mis... - [Git Worktrees for Parallel Development](git-worktrees-for-parallel-development.md): Use git worktrees with isolated services for parallel development on multiple branches simultaneously. - [Interactive mode - prompts for name and base branch](interactive-mode-prompts-for-name-and-base-branch.md): ./scripts/create-worktree.sh - [With arguments](with-arguments.md): ./scripts/create-worktree.sh feature-name # Branches from main (default) - [Custom directory location (default: ../worktrees)](custom-directory-location-default-worktrees.md): WORKTREE_BASE_DIR=/custom/path ./scripts/create-worktree.sh feature-name - [1. Change to the worktree directory (path shown in creation output)](1-change-to-the-worktree-directory-path-shown-in-creation-output.md): cd ../worktrees/{name} - [2. Start PostgreSQL and Redis (in background)](2-start-postgresql-and-redis-in-background.md): make start-bg - [3. Start development servers (Django and Vite)](3-start-development-servers-django-and-vite.md): make dev - [4. (Optional) Start a new Claude session in this directory](4-optional-start-a-new-claude-session-in-this-directory.md): claude - [Remove a worktree (from main directory)](remove-a-worktree-from-main-directory.md): git worktree remove ../worktrees/{name} - [Remove a worktree and delete the branch](remove-a-worktree-and-delete-the-branch.md): git worktree remove ../worktrees/{name} - [From within a worktree (auto-detect ports)](from-within-a-worktree-auto-detect-ports.md): cd ../worktrees/{name} - [From repo root (specify worktree path)](from-repo-root-specify-worktree-path.md): ./scripts/configure-ports.sh ../worktrees/{name} - [Use specific ports (advanced)](use-specific-ports-advanced.md): ./scripts/configure-ports.sh ../worktrees/{name} 8005 5178 5437 6383 - [Standalone React Front End](standalone-react-front-end-2.md): Build decoupled React single-page applications with Vite, session authentication, API integration, and deployment to ... - [Type Checking with Mypy](type-checking-with-mypy.md): Enable static type checking in your Pegasus project using mypy and django-stubs. - [Without uv](without-uv.md): mypy . - [Front End Design Patterns](front-end-design-patterns-2.md): JavaScript design patterns for Pegasus projects including site-wide libraries, npm package integration, and SiteJS ut... - [Migrating from Webpack to Vite](migrating-from-webpack-to-vite-2.md): Step-by-step guide to migrate Pegasus projects from Webpack to Vite bundler with React JSX file extensions and templa... - [Front End Overview](front-end-overview-2.md): Modern JavaScript build pipeline with Vite or Webpack, TypeScript support, CSS compilation, and hybrid Django templat... - [Troubleshooting](troubleshooting-2-2.md): Fix Docker cross-platform file watching issues with webpack polling configuration for Windows and other development e... - [Vite-Specific Instructions](vite-specific-instructions-2.md): Configure Vite with django-vite for fast development server, Hot Module Replacement, and seamless Django template int... - [Webpack-Specific Instructions](webpack-specific-instructions-2.md): Use Webpack for Django front-end builds with dev-watch mode, bundle compilation, and static file management for JavaS... - [How to connect a marketplace app to a Pegasus project](how-to-connect-a-marketplace-app-to-a-pegasus-project-2.md): Connect marketplace apps like Scriv to Pegasus projects via GitHub integration with proper configuration matching and... - [Working with Scriv](working-with-scriv-2.md): Deploy and customize Scriv chat widget application with Fly.io integration, Docker configuration, and npm package pub... - [Working with Python Packages (pip-tools)](working-with-python-packages-pip-tools-2.md): Manage Python dependencies with pip-tools using requirements.in files, pip-compile commands, and Docker container reb... - [native version](native-version-2-2.md): pip-compile requirements/requirements.in - [docker version](docker-version-4-2.md): make pip-compile - [native version](native-version-3-2.md): pip-compile --upgrade-package django requirements/requirements.in - [docker version](docker-version-5-2.md): make pip-complie ARGS="--upgrade-package django" - [native version](native-version-4-2.md): pip-compile --upgrade requirements/requirements.in - [docker version](docker-version-6-2.md): make pip-compile ARGS="--upgrade" - [Python Environment Setup](python-environment-setup-2.md): Set up Pegasus development environments using Docker, uv package manager, virtual environments, or IDE integration fo...