@django-stack/cli 0.6.0 → 0.7.0

package/templates/base/compose.yaml

@@ -2,12 +2,14 @@
 #
 # COMPOSE_PROFILES in .env picks the services:
 #   dev,db    `docker compose up` on a laptop: dev servers with hot reload,
-#             http://localhost:3000, Mailpit at http://localhost:8025.
+#             http://localhost:3000, Mailpit at http://localhost:8025 (the
+#             *_PORT variables in .env change the ports).
 #   prod,db   `docker compose up -d` on a server: production images behind
 #             Caddy on ports 80 and 443, with automatic HTTPS and daily backups.
 #   Leave out `db` to use an external Postgres through DATABASE_URL, and add
 #   `s3` in development for a local S3 service (see .env). `analytics` runs
-#   Umami for page analytics.
+#   Umami for page analytics, `valkey` the Valkey service for CACHE_URL or
+#   TASKS_URL.
 #
 # The frontend only receives the variables it needs: never the full-access
 # API key or the database password.
@@ -42,6 +44,7 @@ x-backend-depends: &backend-depends
     required: false
   cache:
     condition: service_healthy
+    required: false
   s3:
     condition: service_started
     required: false
@@ -72,7 +75,7 @@ services:
       - ./backend:/app
       - media:/app/media
     ports:
-      - "127.0.0.1:8000:8000"
+      - "127.0.0.1:${BACKEND_PORT:-8000}:8000"
     depends_on: *backend-depends
     healthcheck: *backend-health
     restart: unless-stopped
@@ -87,6 +90,9 @@ services:
     volumes:
       - ./backend:/app
       - media:/app/media
+    # 0 with TASKS_URL=immediate://: tasks run in the request.
+    deploy:
+      replicas: ${TASK_WORKERS:-1}
     depends_on:
       backend:
         condition: service_healthy
@@ -102,7 +108,7 @@ services:
       - ./frontend:/app
       - frontend_node_modules:/app/node_modules
     ports:
-      - "127.0.0.1:3000:3000"
+      - "127.0.0.1:${SITE_PORT:-3000}:3000"
     depends_on:
       backend:
         condition: service_healthy
@@ -112,11 +118,12 @@ services:
     profiles: [dev]
     image: axllent/mailpit:v1.27
     ports:
-      - "127.0.0.1:8025:8025"
+      - "127.0.0.1:${MAIL_PORT:-8025}:8025"
     restart: unless-stopped
 
   # A local S3 service, so development runs the same storage code as
-  # production with S3. Files are public at http://localhost:8333/<bucket>/.
+  # production with S3. Files are public at http://localhost:8333/<bucket>/
+  # (S3_PORT).
   s3:
     profiles: [s3]
     image: chrislusf/seaweedfs:4.52
@@ -124,7 +131,7 @@ services:
     volumes:
       - s3data:/data
     ports:
-      - "127.0.0.1:8333:8333"
+      - "127.0.0.1:${S3_PORT:-8333}:8333"
     restart: unless-stopped
 
   # Production -------------------------------------------------------------
@@ -181,6 +188,7 @@ services:
     healthcheck:
       disable: true
     deploy:
+      replicas: ${TASK_WORKERS:-1}
       resources:
         limits:
           memory: 512M
@@ -292,9 +300,11 @@ services:
           memory: 1G
     restart: unless-stopped
 
-  # Cache, sessions and the task queue. Only keys with an expiry are
-  # evicted when memory runs out, so queued tasks are never dropped.
+  # Valkey (the valkey profile), for CACHE_URL or TASKS_URL redis://cache.
+  # Only keys with an expiry are evicted when memory runs out, so queued
+  # tasks are never dropped.
   cache:
+    profiles: [valkey]
     image: valkey/valkey:8-alpine
     user: valkey
     command: ["valkey-server", "--save", "", "--appendonly", "no", "--maxmemory", "200mb", "--maxmemory-policy", "volatile-lru"]

package/templates/base/env.example

@@ -8,7 +8,8 @@ PROJECT_NAME={{project_name}}
 #   dev,db   development on this machine
 #   prod,db  production on a server
 # Leave out `db` when DATABASE_URL points to an external Postgres; add `s3`
-# in development for the local S3 service. `analytics` runs Umami.
+# in development for the local S3 service. `analytics` runs Umami, `valkey`
+# the Valkey service.
 COMPOSE_PROFILES=dev,db
 
 # The public URL of the site. In development the frontend's dev server also
@@ -17,6 +18,15 @@ COMPOSE_PROFILES=dev,db
 SITE_URL=http://localhost:3000
 BACKEND_URL=http://localhost:3000
 
+# The ports of the development services on this machine: the site with the
+# admin, the backend, Mailpit and the local S3 service. `init` and
+# `dstack dev` move to free ones when these are in use, and change the
+# URLs above with SITE_PORT.
+SITE_PORT=3000
+BACKEND_PORT=8000
+MAIL_PORT=8025
+S3_PORT=8333
+
 # Behind the proxy of a platform such as Coolify or Dokploy, which gets the
 # certificate, Caddy serves plain HTTP on port 80 to it instead:
 #   CADDY_ADDRESS=:80 TRUSTED_PROXIES=private_ranges NUM_PROXIES=2
@@ -33,9 +43,18 @@ POSTGRES_USER=app
 POSTGRES_PASSWORD={{secret:postgres}}
 DATABASE_URL=postgres://app:{{secret:postgres}}@db:5432/app
 
-# Cache, task queue and mail. In production, EMAIL_URL is your SMTP server,
-# such as smtp+tls://user:password@smtp.example.com:587.
-CACHE_URL=redis://cache:6379/0
+# Cache and task queue: db:// keeps them in tables in the database, so
+# nothing else runs. For the Valkey service add `valkey` to COMPOSE_PROFILES
+# and use redis://cache:6379/0 (the cache) or redis://cache:6379/1 (the
+# tasks). CACHE_URL=locmem:// is a cache per process. TASKS_URL=immediate://
+# runs tasks in the request, with TASK_WORKERS=0 to stop the worker; there
+# are no daily backups then.
+CACHE_URL=db://
+TASKS_URL=db://
+TASK_WORKERS=1
+
+# Mail. In production, EMAIL_URL is your SMTP server, such as
+# smtp+tls://user:password@smtp.example.com:587.
 EMAIL_URL=smtp://mailpit:1025
 DEFAULT_FROM_EMAIL={{project_name}} <noreply@localhost>
 

package/templates/frontend-astro/package.json

@@ -16,7 +16,7 @@
     "@astrojs/node": "^11.1.9",
     "@astrojs/rss": "^4.0.19",
     "@django-headless/client": "^1.1.1",
-    "@django-stack/utils": "^0.6.0",
+    "@django-stack/utils": "^0.7.0",
     "astro": "^7.4.5"
   },
   "devDependencies": {

package/templates/frontend-next/package.json

@@ -13,9 +13,9 @@
   },
   "dependencies": {
     "@django-headless/client": "^1.1.1",
-    "@django-stack/next": "^0.6.0",
-    "@django-stack/react": "^0.6.0",
-    "@django-stack/utils": "^0.6.0",
+    "@django-stack/next": "^0.7.0",
+    "@django-stack/react": "^0.7.0",
+    "@django-stack/utils": "^0.7.0",
     "next": "^16.4.4",
     "react": "^19.3.1",
     "react-dom": "^19.3.1",

package/templates/frontend-nuxt/package.json

@@ -15,8 +15,8 @@
   },
   "dependencies": {
     "@django-headless/client": "^1.1.1",
-    "@django-stack/utils": "^0.6.0",
-    "@django-stack/vue": "^0.6.0",
+    "@django-stack/utils": "^0.7.0",
+    "@django-stack/vue": "^0.7.0",
     "nuxt": "^4.6.3",
     "nuxt-security": "^2.7.0",
     "vue": "^3.5.44",

package/templates/frontend-sveltekit/package.json

@@ -19,8 +19,8 @@
   },
   "dependencies": {
     "@django-headless/client": "^1.1.1",
-    "@django-stack/svelte": "^0.6.0",
-    "@django-stack/utils": "^0.6.0"
+    "@django-stack/svelte": "^0.7.0",
+    "@django-stack/utils": "^0.7.0"
   },
   "devDependencies": {
     "@sveltejs/adapter-node": "^6.0.1",