@pradip1995/create-storefront-app 0.2.3 → 0.3.1

package/templates/backend/src/scripts/seed.ts

@@ -0,0 +1,210 @@
+import type { ExecArgs } from "@medusajs/framework/types"
+import {
+  ContainerRegistrationKeys,
+  Modules,
+  ProductStatus,
+} from "@medusajs/framework/utils"
+import {
+  createApiKeysWorkflow,
+  createInventoryLevelsWorkflow,
+  createProductCategoriesWorkflow,
+  createProductsWorkflow,
+  createRegionsWorkflow,
+  createSalesChannelsWorkflow,
+  createShippingOptionsWorkflow,
+  createShippingProfilesWorkflow,
+  createStockLocationsWorkflow,
+  createTaxRegionsWorkflow,
+  linkSalesChannelsToApiKeyWorkflow,
+  linkSalesChannelsToStockLocationWorkflow,
+  updateStoresWorkflow,
+} from "@medusajs/medusa/core-flows"
+
+const SEED_COUNTRIES = ["{{DEFAULT_REGION}}"]
+const SEED_CURRENCY = "{{DEFAULT_CURRENCY}}"
+const SEED_REGION_NAME = "{{DEFAULT_REGION_NAME}}"
+
+export default async function seedStore({ container }: ExecArgs) {
+  const logger = container.resolve(ContainerRegistrationKeys.LOGGER)
+  const link = container.resolve(ContainerRegistrationKeys.LINK)
+  const fulfillmentModuleService = container.resolve(Modules.FULFILLMENT)
+  const salesChannelModuleService = container.resolve(Modules.SALES_CHANNEL)
+  const storeModuleService = container.resolve(Modules.STORE)
+
+  logger.info("Seeding store...")
+  const [store] = await storeModuleService.listStores()
+
+  let [salesChannel] = await salesChannelModuleService.listSalesChannels({
+    name: "Default Sales Channel",
+  })
+  if (!salesChannel) {
+    const { result } = await createSalesChannelsWorkflow(container).run({
+      input: { salesChannelsData: [{ name: "Default Sales Channel" }] },
+    })
+    salesChannel = result[0]
+  }
+
+  await updateStoresWorkflow(container).run({
+    input: {
+      selector: { id: store.id },
+      update: {
+        default_sales_channel_id: salesChannel.id,
+        supported_currencies: [{ currency_code: SEED_CURRENCY, is_default: true }],
+      },
+    },
+  })
+
+  logger.info("Seeding region...")
+  const { result: regions } = await createRegionsWorkflow(container).run({
+    input: {
+      regions: [
+        {
+          name: SEED_REGION_NAME,
+          currency_code: SEED_CURRENCY,
+          countries: SEED_COUNTRIES,
+          payment_providers: ["pp_system_default"],
+        },
+      ],
+    },
+  })
+  const region = regions[0]
+
+  await createTaxRegionsWorkflow(container).run({
+    input: SEED_COUNTRIES.map((country_code) => ({
+      country_code,
+      provider_id: "tp_system",
+    })),
+  })
+
+  const { result: stockLocations } = await createStockLocationsWorkflow(container).run({
+    input: {
+      locations: [
+        {
+          name: "Primary Warehouse",
+          address: { city: "Default", country_code: SEED_COUNTRIES[0], address_1: "" },
+        },
+      ],
+    },
+  })
+  const stockLocation = stockLocations[0]
+
+  await updateStoresWorkflow(container).run({
+    input: {
+      selector: { id: store.id },
+      update: { default_location_id: stockLocation.id },
+    },
+  })
+
+  await link.create({
+    [Modules.STOCK_LOCATION]: { stock_location_id: stockLocation.id },
+    [Modules.FULFILLMENT]: { fulfillment_provider_id: "manual_manual" },
+  })
+
+  const shippingProfiles = await fulfillmentModuleService.listShippingProfiles({ type: "default" })
+  let shippingProfile = shippingProfiles[0]
+  if (!shippingProfile) {
+    const { result } = await createShippingProfilesWorkflow(container).run({
+      input: { data: [{ name: "Default Shipping Profile", type: "default" }] },
+    })
+    shippingProfile = result[0]
+  }
+
+  const fulfillmentSet = await fulfillmentModuleService.createFulfillmentSets({
+    name: "Primary delivery",
+    type: "shipping",
+    service_zones: [
+      {
+        name: SEED_REGION_NAME,
+        geo_zones: SEED_COUNTRIES.map((country_code) => ({ country_code, type: "country" as const })),
+      },
+    ],
+  })
+
+  await link.create({
+    [Modules.STOCK_LOCATION]: { stock_location_id: stockLocation.id },
+    [Modules.FULFILLMENT]: { fulfillment_set_id: fulfillmentSet.id },
+  })
+
+  await createShippingOptionsWorkflow(container).run({
+    input: [
+      {
+        name: "Standard Shipping",
+        price_type: "flat",
+        provider_id: "manual_manual",
+        service_zone_id: fulfillmentSet.service_zones[0].id,
+        shipping_profile_id: shippingProfile.id,
+        type: { label: "Standard", description: "Ship in 2-5 days.", code: "standard" },
+        prices: [{ currency_code: SEED_CURRENCY, amount: 0 }, { region_id: region.id, amount: 0 }],
+        rules: [
+          { attribute: "enabled_in_store", value: "true", operator: "eq" },
+          { attribute: "is_return", value: "false", operator: "eq" },
+        ],
+      },
+    ],
+  })
+
+  await linkSalesChannelsToStockLocationWorkflow(container).run({
+    input: { id: stockLocation.id, add: [salesChannel.id] },
+  })
+
+  logger.info("Creating publishable API key...")
+  const { result: apiKeys } = await createApiKeysWorkflow(container).run({
+    input: {
+      api_keys: [{ title: "Storefront", type: "publishable", created_by: "" }],
+    },
+  })
+  const publishableKey = apiKeys[0]
+  await linkSalesChannelsToApiKeyWorkflow(container).run({
+    input: { id: publishableKey.id, add: [salesChannel.id] },
+  })
+
+  logger.info("Seeding sample category and product...")
+  const { result: categories } = await createProductCategoriesWorkflow(container).run({
+    input: { product_categories: [{ name: "Featured", is_active: true }] },
+  })
+
+  const { result: products } = await createProductsWorkflow(container).run({
+    input: {
+      products: [
+        {
+          title: "Sample Product",
+          handle: "sample-product",
+          status: ProductStatus.PUBLISHED,
+          category_ids: [categories[0].id],
+          options: [{ title: "Size", values: ["S", "M", "L"] }],
+          variants: [
+            {
+              title: "S",
+              sku: "SAMPLE-S",
+              options: { Size: "S" },
+              prices: [{ currency_code: SEED_CURRENCY, amount: 999 }],
+            },
+          ],
+          sales_channels: [{ id: salesChannel.id }],
+        },
+      ],
+    },
+  })
+
+  const inventoryModule = container.resolve(Modules.INVENTORY)
+  const inventoryItems = await inventoryModule.listInventoryItems({ sku: "SAMPLE-S" })
+  if (inventoryItems[0]) {
+    await createInventoryLevelsWorkflow(container).run({
+      input: {
+        inventory_levels: [
+          {
+            inventory_item_id: inventoryItems[0].id,
+            location_id: stockLocation.id,
+            stocked_quantity: 100,
+          },
+        ],
+      },
+    })
+  }
+
+  logger.info("")
+  logger.info("=== Seed complete ===")
+  logger.info(`Region: ${SEED_REGION_NAME} (${SEED_COUNTRIES.join(", ")})`)
+  logger.info(`Publishable API key id: ${publishableKey.id}`)
+  logger.info(`Sample product: ${products[0]?.handle}`)
+}

package/templates/backend/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2021",
+    "esModuleInterop": true,
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "skipLibCheck": true,
+    "declaration": false,
+    "outDir": "./.medusa/server",
+    "rootDir": "./",
+    "jsx": "react-jsx",
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "strictNullChecks": true
+  },
+  "ts-node": {
+    "compiler": "typescript",
+    "transpileOnly": true
+  },
+  "include": ["**/*", ".medusa/types/*"],
+  "exclude": ["node_modules", ".medusa/server", ".medusa/admin", ".cache"]
+}

package/templates/docker/Makefile

@@ -0,0 +1,88 @@
+.DEFAULT_GOAL := help
+
+COMPOSE := docker compose --env-file docker/.env
+COMPOSE_INFRA := docker compose -f docker-compose.infra.yml --env-file docker/.env
+ENV_FILE := docker/.env
+ENV_EXAMPLE := docker/.env.example
+
+INFRA_SERVICES := postgres redis mailpit
+BACKEND_SERVICES := postgres redis mailpit backend
+ALL_SERVICES := postgres redis mailpit backend storefront
+
+ADMIN_EMAIL ?= {{ADMIN_EMAIL}}
+ADMIN_PASSWORD ?= {{ADMIN_PASSWORD}}
+
+.PHONY: help env-init up up-infra up-backend up-storefront down restart build build-backend build-storefront \
+	logs logs-backend logs-storefront ps health migrate admin-create seed db-shell mailpit clean
+
+help: ## Show available commands
+	@grep -E '^[a-zA-Z0-9_-]+:.*##' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+env-init: ## Copy docker/.env.example → docker/.env (skip if exists)
+	@test -f $(ENV_FILE) || cp $(ENV_EXAMPLE) $(ENV_FILE)
+	@echo "Ready: $(ENV_FILE)"
+
+up: env-init build ## Build and start full stack in Docker
+	$(COMPOSE) up -d $(ALL_SERVICES)
+
+up-infra: env-init ## Start postgres, redis, mailpit only (for local npm dev)
+	$(COMPOSE_INFRA) up -d $(INFRA_SERVICES)
+
+up-backend: env-init build-backend ## Start postgres, redis, mailpit, backend in Docker
+	$(COMPOSE) up -d $(BACKEND_SERVICES)
+
+migrate: env-init ## Run DB migrations (fresh DB may need two runs)
+	-$(COMPOSE) run --rm --no-deps backend npx medusa db:migrate
+	$(COMPOSE) run --rm --no-deps backend npx medusa db:migrate
+
+up-storefront: env-init build-storefront ## Start storefront container (requires backend)
+	$(COMPOSE) up -d storefront
+
+down: ## Stop all containers
+	-$(COMPOSE) down
+	-$(COMPOSE_INFRA) down
+
+restart: down up ## Restart full Docker stack
+
+build: build-backend build-storefront ## Build all images
+
+build-backend: env-init ## Build backend image
+	$(COMPOSE) build backend
+
+build-storefront: env-init ## Build storefront image
+	@test -f $(ENV_FILE) || (echo "Missing $(ENV_FILE). Run: make env-init" && exit 1)
+	$(COMPOSE) build storefront
+
+logs: ## Tail logs (all services)
+	$(COMPOSE) logs -f
+
+logs-backend: ## Tail backend logs
+	$(COMPOSE) logs -f backend
+
+logs-storefront: ## Tail storefront logs
+	$(COMPOSE) logs -f storefront
+
+ps: ## Show container status
+	$(COMPOSE) ps
+
+health: ## Check backend and storefront HTTP health
+	@curl -sf {{BACKEND_URL}}/health >/dev/null && echo "backend:    OK ({{BACKEND_URL}})" || echo "backend:    FAIL"
+	@curl -sf -o /dev/null -w "" {{BASE_URL}}/{{DEFAULT_REGION}} 2>/dev/null && echo "storefront: OK ({{BASE_URL}})" || echo "storefront: FAIL (start with: make up-storefront or npm run dev:storefront)"
+
+admin-create: ## Create admin user (ADMIN_EMAIL / ADMIN_PASSWORD)
+	$(COMPOSE) exec backend npx medusa user -e $(ADMIN_EMAIL) -p '$(ADMIN_PASSWORD)'
+
+seed: ## Run Medusa seed, then sync publishable key to storefront env
+	$(COMPOSE) exec backend npx medusa exec ./src/scripts/seed.ts
+	@token=$$($(COMPOSE) exec -T postgres psql -U {{POSTGRES_USER}} -d {{POSTGRES_DB}} -tAc "SELECT token FROM api_key WHERE type = 'publishable' AND deleted_at IS NULL AND revoked_at IS NULL ORDER BY created_at DESC LIMIT 1" | tr -d '[:space:]'); \
+	node scripts/sync-publishable-key.mjs "$$token"
+
+db-shell: ## Open psql in postgres container
+	$(COMPOSE) exec postgres psql -U {{POSTGRES_USER}} -d {{POSTGRES_DB}}
+
+mailpit: ## Open Mailpit UI URL
+	@echo "http://localhost:8025"
+
+clean: ## Stop containers and remove volumes (destroys DB data)
+	$(COMPOSE) down -v
+	$(COMPOSE_INFRA) down -v

package/templates/docker/backend/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+.medusa
+.git
+.env
+.env.*
+npm-debug.log*
+Dockerfile
+.dockerignore

package/templates/docker/backend/Dockerfile

@@ -0,0 +1,30 @@
+FROM node:24-alpine AS builder
+
+WORKDIR /app
+
+COPY package.json package-lock.json* ./
+RUN npm install --prefer-offline --no-audit --legacy-peer-deps
+
+COPY . .
+RUN npm run build
+
+RUN if [ -d templates ]; then cp -r templates .medusa/server/; fi
+
+FROM node:24-alpine AS runner
+
+WORKDIR /app
+
+ENV NODE_ENV=production
+
+COPY --from=builder /app/.medusa/server ./
+COPY --from=builder /app/medusa-config.ts ./medusa-config.ts
+COPY --from=builder /app/config ./config
+COPY --from=builder /app/package.json ./package.json
+COPY --from=builder /app/package-lock.json* ./
+
+RUN npm install --omit=dev --prefer-offline --no-audit --legacy-peer-deps \
+  && npm install --save-prod ts-node typescript --prefer-offline --no-audit --legacy-peer-deps
+
+EXPOSE 9000
+
+CMD ["npm", "run", "start"]

package/templates/docker/data/README.md

@@ -0,0 +1,12 @@
+# Database dumps
+
+Place `dump.sql` here to restore on first postgres startup (see `docker-compose.yml`).
+
+On container shutdown, postgres saves a dump here when the database has tables.
+
+For fresh installs, use:
+
+```bash
+make migrate
+make seed
+```

package/templates/docker/data/dump.sql

@@ -0,0 +1,3 @@
+-- Optional database restore file (mounted into postgres init).
+-- Fresh installs: leave as-is and run `make migrate` + `make seed` instead.
+SELECT 1;

package/templates/docker/docker/.env.example

@@ -0,0 +1,36 @@
+# Copy to docker/.env and fill in secrets only.
+# Usage: docker compose --env-file docker/.env up -d --build
+#
+# Non-critical defaults are in docker-compose.yml.
+
+# --- Backend secrets ---
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
+AWS_ACCESS_KEY=
+AWS_SECRET_ACCESS_KEY=
+AWS_BUCKET=
+CASHFREE_CLIENT_ID=
+CASHFREE_CLIENT_SECRET=
+SHIPROCKET_EMAIL=
+SHIPROCKET_PASSWORD=
+SHIPROCKET_WEBHOOK_SECRET=
+TWILIO_ACCOUNT_SID=
+TWILIO_AUTH_TOKEN=
+TWILIO_PHONE=
+FCM_PROJECT_ID=
+FCM_CLIENT_EMAIL=
+FCM_PRIVATE_KEY=
+
+# --- Storefront secrets (update publishable key after make seed) ---
+NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY={{PUBLISHABLE_KEY}}
+NEXT_PUBLIC_RAZORPAY_KEY=
+NEXT_PUBLIC_GOOGLE_CLIENT_ID=
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=
+NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=
+NEXT_PUBLIC_FIREBASE_APP_ID=
+NEXT_PUBLIC_FIREBASE_VAPID_KEY=
+FB_PIXEL_ID=
+FB_ACCESS_TOKEN=

package/templates/docker/docker/frontend.build.defaults

@@ -0,0 +1,7 @@
+MEDUSA_BACKEND_URL=http://backend:9000
+NEXT_PUBLIC_MEDUSA_BACKEND_URL={{BACKEND_URL}}
+NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY={{PUBLISHABLE_KEY}}
+NEXT_PUBLIC_BASE_URL={{BASE_URL}}
+NEXT_PUBLIC_DEFAULT_REGION={{DEFAULT_REGION}}
+NEXT_PUBLIC_CASHFREE_ENVIRONMENT=sandbox
+FILE_LOCAL_BACKEND_URL={{BACKEND_URL}}

package/templates/docker/docker/gitignore

@@ -0,0 +1 @@
+.env

package/templates/docker/docker/postgres/01-create-postgres-role.sql

@@ -0,0 +1,9 @@
+-- Optional restore helper when using pg_dump in data/dump.sql.
+-- Adds a `postgres` role some dumps expect alongside POSTGRES_USER.
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'postgres') THEN
+    CREATE ROLE postgres WITH SUPERUSER LOGIN PASSWORD '{{POSTGRES_PASSWORD}}';
+  END IF;
+END
+$$;

package/templates/docker/docker/postgres/docker-entrypoint-wrapper.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+set -euo pipefail
+
+DUMP_PATH="${DUMP_PATH:-/dump/dump.sql}"
+MIN_TABLES="${MIN_TABLES_FOR_DUMP:-1}"
+
+dump_database() {
+  if [ -z "${POSTGRES_USER:-}" ] || [ -z "${POSTGRES_DB:-}" ]; then
+    return 0
+  fi
+
+  if ! pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  local table_count
+  table_count=$(
+    psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -tAc \
+      "SELECT count(*) FROM information_schema.tables WHERE table_schema = 'public';" \
+      2>/dev/null || echo "0"
+  )
+
+  if [ "${table_count:-0}" -lt "$MIN_TABLES" ]; then
+    echo "Skipping dump: public schema has ${table_count:-0} table(s)."
+    return 0
+  fi
+
+  echo "Saving database dump (${table_count} tables) to ${DUMP_PATH} ..."
+  pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fp > "${DUMP_PATH}.tmp"
+  mv "${DUMP_PATH}.tmp" "${DUMP_PATH}"
+  echo "Database dump saved."
+}
+
+shutdown_postgres() {
+  dump_database
+
+  if [ -n "${child_pid:-}" ]; then
+    kill -TERM "$child_pid" 2>/dev/null || true
+    wait "$child_pid" 2>/dev/null || true
+  fi
+
+  exit 0
+}
+
+trap shutdown_postgres SIGTERM SIGINT
+
+/usr/local/bin/docker-entrypoint.sh "$@" &
+child_pid=$!
+wait "$child_pid"

package/templates/docker/docker-compose.infra.yml

@@ -0,0 +1,64 @@
+# Infrastructure only — use with local Node dev (npm run dev:backend / dev:storefront).
+# Usage: docker compose -f docker-compose.infra.yml --env-file docker/.env up -d
+
+x-postgres-user: &postgres-user {{POSTGRES_USER}}
+x-postgres-password: &postgres-password {{POSTGRES_PASSWORD}}
+x-postgres-db: &postgres-db {{POSTGRES_DB}}
+
+services:
+  postgres:
+    image: postgres:18-alpine
+    container_name: {{CONTAINER_PREFIX}}-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: *postgres-user
+      POSTGRES_PASSWORD: *postgres-password
+      POSTGRES_DB: *postgres-db
+      DUMP_PATH: /dump/dump.sql
+    volumes:
+      - postgres_data:/var/lib/postgresql
+      - ./docker/postgres/01-create-postgres-role.sql:/docker-entrypoint-initdb.d/01-create-postgres-role.sql:ro
+      - ./data/dump.sql:/docker-entrypoint-initdb.d/02-dump.sql:ro
+      - ./data:/dump
+      - ./docker/postgres/docker-entrypoint-wrapper.sh:/usr/local/bin/docker-entrypoint-wrapper.sh:ro
+    entrypoint: ["/usr/local/bin/docker-entrypoint-wrapper.sh"]
+    command: ["postgres"]
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+      start_period: 120s
+
+  redis:
+    image: redis:7-alpine
+    container_name: {{CONTAINER_PREFIX}}-redis
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  mailpit:
+    image: axllent/mailpit
+    container_name: {{CONTAINER_PREFIX}}-mailpit
+    restart: unless-stopped
+    ports:
+      - "8025:8025"
+      - "1025:1025"
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:8025/livez"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  postgres_data:
+  redis_data:

package/templates/docker/docker-compose.yml

@@ -0,0 +1,138 @@
+# Usage: docker compose --env-file docker/.env up -d --build
+#
+# Copy docker/.env.example to docker/.env and fill in secrets.
+# Non-critical defaults are in docker-compose.yml (and docker/frontend.build.defaults for image build).
+# Mailpit UI: http://localhost:8025
+
+x-postgres-user: &postgres-user {{POSTGRES_USER}}
+x-postgres-password: &postgres-password {{POSTGRES_PASSWORD}}
+x-postgres-db: &postgres-db {{POSTGRES_DB}}
+x-database-url: &database-url {{DATABASE_URL_DOCKER}}
+
+x-backend-docker-env: &backend-docker-env
+  NODE_ENV: production
+  DATABASE_URL: *database-url
+  REDIS_URL: redis://redis:6379
+  JWT_SECRET: supersecret
+  COOKIE_SECRET: supersecret
+  STORE_CORS: {{BASE_URL}},{{BACKEND_URL}}
+  ADMIN_CORS: {{BACKEND_URL}},http://localhost:7001
+  AUTH_CORS: {{BASE_URL}},{{BACKEND_URL}}
+  STOREFRONT_URL: {{BASE_URL}}
+  MEDUSA_BACKEND_URL: {{BACKEND_URL}}
+  GOOGLE_CALLBACK_URL: {{BASE_URL}}/auth/customer/google/callback
+  AWS_REGION: ap-south-1
+  CASHFREE_ENVIRONMENT: sandbox
+  SHIPROCKET_PICKUP_LOCATION: Primary
+  SMTP_HOST: mailpit
+  SMTP_PORT: "1025"
+  SMTP_SECURE: "false"
+  SMTP_FROM: noreply@{{CONTAINER_PREFIX}}.local
+
+x-storefront-docker-env: &storefront-docker-env
+  MEDUSA_BACKEND_URL: http://backend:9000
+  NEXT_PUBLIC_MEDUSA_BACKEND_URL: {{BACKEND_URL}}
+  NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY: {{PUBLISHABLE_KEY}}
+  NEXT_PUBLIC_BASE_URL: {{BASE_URL}}
+  NEXT_PUBLIC_DEFAULT_REGION: {{DEFAULT_REGION}}
+  NEXT_PUBLIC_CASHFREE_ENVIRONMENT: sandbox
+  FILE_LOCAL_BACKEND_URL: {{BACKEND_URL}}
+
+secrets:
+  frontend_defaults:
+    file: ./docker/frontend.build.defaults
+  app_env:
+    file: ./docker/.env
+
+services:
+  postgres:
+    image: postgres:18-alpine
+    container_name: {{CONTAINER_PREFIX}}-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: *postgres-user
+      POSTGRES_PASSWORD: *postgres-password
+      POSTGRES_DB: *postgres-db
+      DUMP_PATH: /dump/dump.sql
+    volumes:
+      - postgres_data:/var/lib/postgresql
+      - ./docker/postgres/01-create-postgres-role.sql:/docker-entrypoint-initdb.d/01-create-postgres-role.sql:ro
+      - ./data/dump.sql:/docker-entrypoint-initdb.d/02-dump.sql:ro
+      - ./data:/dump
+      - ./docker/postgres/docker-entrypoint-wrapper.sh:/usr/local/bin/docker-entrypoint-wrapper.sh:ro
+    entrypoint: ["/usr/local/bin/docker-entrypoint-wrapper.sh"]
+    command: ["postgres"]
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+      start_period: 120s
+
+  redis:
+    image: redis:7-alpine
+    container_name: {{CONTAINER_PREFIX}}-redis
+    restart: unless-stopped
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  mailpit:
+    image: axllent/mailpit
+    container_name: {{CONTAINER_PREFIX}}-mailpit
+    restart: unless-stopped
+    ports:
+      - "8025:8025"
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:8025/livez"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  backend:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    container_name: {{CONTAINER_PREFIX}}-backend
+    env_file:
+      - path: docker/.env
+        required: false
+    environment:
+      <<: *backend-docker-env
+    ports:
+      - "9000:9000"
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      mailpit:
+        condition: service_healthy
+
+  storefront:
+    build:
+      context: ./storefront
+      dockerfile: Dockerfile
+      secrets:
+        - frontend_defaults
+        - app_env
+    container_name: {{CONTAINER_PREFIX}}-storefront
+    env_file:
+      - path: docker/.env
+        required: false
+    environment:
+      <<: *storefront-docker-env
+    ports:
+      - "8000:8000"
+    depends_on:
+      - backend
+
+volumes:
+  postgres_data:
+  redis_data: