Stackbase - v2.1.0

Stackbase v2.1.0: Build Elevate Migration

Adds a safe migration path from Build Elevate to Stackbase, with legacy manifest conversion, conflict protection, and a complete migration guide.

Added

• Build Elevate migration: Added stackbase migrate to convert .build-elevate.json into .stackbase.json, update unchanged files, and retain local edits as conflicts
• Legacy compatibility: Maps the fullstack template to base, detects missing feature flags, and reads legacy template files from their original repository paths
• Migration guide: Added a step-by-step guide covering dry runs, conflict resolution, verification, backup cleanup, and rollback

Changed

• Manifest tracking: Keeps the legacy source and commit until migration conflicts are resolved, then continues with the standard Stackbase upgrade flow
• Manifest backup: Saves the original manifest as .build-elevate.json.bak after a successful migration

Fixed

• Upgrade safety: Treats new template files that collide with existing local files as conflicts instead of overwriting them

Stackbase - v2.0.0

Stackbase v2.0.0 — Standalone Modular Architecture & Multi-PM Automation

Major release introducing standalone templates (base, web, api), complete Bun runtime support alongside pnpm and npm, archive-based degit downloading, and non-interactive CLI flags for automated CI/CD scaffolding.

Added

• Standalone Architecture Templates: Dedicated, self-contained templates (base, web, api) replacing monolithic repository pruning for cleaner scaffolds, faster dependency resolution, and predictable project boundaries
• First-Class Bun Support: Full runtime, dependency management, and script execution support for Bun (-p bun) across all templates with 100% test, build, lint, and type check parity
• Non-Interactive Scaffolding Flags: Full suite of command-line flags for zero-prompt automation:
  • --docker / --no-docker: Control Docker container setup and Compose files
  • --k8s, --kubernetes / --no-k8s, --no-kubernetes: Toggle Kubernetes deployment manifests and Ingress
  • --observability (--obs) / --no-observability (--no-obs): Toggle Prometheus & Grafana monitoring stack
  • --studio / --no-studio: Toggle Prisma Studio database browser
• High-Speed Template Delivery: Archive-based tarball downloads via degit replacing full Git clones, retaining commit SHA metadata in .stackbase.json for seamless future upgrades
• Automated Matrix Runner: Permutation and combination verification runner validating 5-stage quality gates (check-types, lint, format:check, test, build) across package managers and templates

Changed

• Templates: Pinned Prettier configuration across all templates to eliminate cross-package-manager AST differences
• ESLint Config: Disabled conflicting react-hooks/set-state-in-effect rule from eslint-plugin-react-hooks@7 across Next.js and React internal configs
• TypeScript: Resolved composite project references across apps/web to ensure clean initial type compilation without prior artifact requirements

Fixed

• Formatting: Resolved long-line attribute wrapping for external links in page.tsx during project name substitution
• Upgrade Tracking: Corrected template hash baselines in .stackbase.json to prevent false conflict warnings on clean scaffolds

Build Elevate - v1.7.1

Organization Migration & Web Catalog Resolution

Updates repository routing to the stackbase-labs/stackbase organization on the legacy branch and resolves pnpm catalog dependencies for web-only projects.

Fixed

• CLI: Point template cloning, diffs, upgrades, and latest commit lookups to stackbase-labs/stackbase#legacy
• Catalog: Moved pino, pino-http, and pino-pretty to the core catalog so @workspace/logger resolves dependencies cleanly in web-only templates where the server catalog is removed
• Format: Added @workspace/prettier-config to api, db, and ui devDependencies to resolve Prettier configuration resolution in isolated workspaces
• Package: Updated repository, homepage, and bugs metadata in package.json to the new organization

Build Elevate - v1.7.0

API Observability with Prometheus & Grafana

Adds first-class API observability with Prometheus-compatible metrics, local Prometheus/Grafana infrastructure, and documentation for inspecting request and runtime behavior during development.

Added

• Prometheus-compatible /metrics endpoint exposing HTTP request counts, request duration histograms, in-flight request gauges, and Node.js runtime metrics
• RED metrics middleware that records request rate, errors, and duration while excluding scraper and probe traffic from application metrics
• Local Prometheus and Grafana compose stack with a provisioned Prometheus data source and API overview dashboard
• Scaffold script updates that keep observability assets, Docker scripts, project-name replacement, and generated README output aligned with selected template options
• Prometheus scrape annotations on API pods for clusters with Prometheus-compatible service discovery
• Observability guide covering local startup, Prometheus targets, Grafana dashboard provisioning, metric names, Kubernetes notes, and troubleshooting

Build Elevate - v1.6.0

Cloud File Storage, Interactive DX & Storage Scaffolding

Adds vendor-agnostic S3-compatible cloud storage (@workspace/storage) with presigned URLs, contracts, API endpoints, and FileUploader UI dropzone, alongside an interactive DX lifecycle and TypeFlow architecture trace in docs, with full CLI scaffolding integration.

Added

• Storage: New @workspace/storage package providing vendor-agnostic S3-compatible cloud storage (AWS S3, Cloudflare R2, MinIO, Supabase Storage) with direct client presigned PUT/GET URLs, object deletion, and collision-safe key generation
• Contracts: Storage schemas and MIME/size limits (getPresignedUploadUrlSchema, deleteStorageFileSchema) in @workspace/contracts
• API: Authenticated /api/storage/presigned-upload and /api/storage/file endpoints with user-scoped access control
• UI: Reusable <FileUploader /> dropzone component in @workspace/ui with drag-and-drop, progress bar, and file validation
• Web: Interactive avatar upload and removal in General Settings (apps/web/components/profile/avatar-uploader.tsx) syncing directly with Better Auth
• Docs: Interactive 4-step DX lifecycle simulation and interactive TypeFlow architecture trace with syntax-highlighted IDE view
• Docs: Complete storage guide at apps/docs/content/docs/packages/storage.mdx covering S3/R2/MinIO setup and CORS configuration
• CLI: Updated scaffolding, Turbo lint envs, and project readme generation to include storage environment variables and packages

Build Elevate - v1.5.2

Dynamic Kubernetes Configuration & Environment Template Fixes

Enhances the Kubernetes scaffolding option with interactive prompts for Docker Hub username and domain name, and ensures LOG_LEVEL and POD_NAME are preserved in environment templates.

Added

• CLI: Interactive prompts for Docker Hub username and production domain name when scaffolding Kubernetes manifests.

Changed

• Kubernetes: Configured dynamic replacements for the domain in Ingress manifests and uncommented TLS cert-manager configurations.

Fixed

• CLI: Updated environment templates to properly retain LOG_LEVEL and POD_NAME across scaffolding options.

Build Elevate - v1.5.1

Respect Opted-Out Features on Upgrade

Fixes the upgrade command re-adding files for optional features that were declined when the project was created, and stops repo-only contributor guides from leaking into scaffolded projects.

Fixed

• CLI: upgrade no longer re-adds files for optional features (Docker, Kubernetes, Prisma Studio) that were declined at scaffold time — the manifest now records chosen features (version and features fields).
• CLI: Scaffolding now removes repo-only CONTRIBUTING.md and SECURITY.md guides instead of shipping them into generated projects.

Build Elevate - v1.5.0

Force Upgrade Past Conflicts

Adds a --force flag to the upgrade command so you can advance a project to the latest template commit even when files conflict, without losing your local edits.

Added

• CLI: upgrade --force advances the manifest to the latest commit while keeping your local edits, for each conflicting file it records the template's latest hash as the new base (the template content is never written to disk) so the conflict clears, your file is left untouched, and it only re-flags if the template changes that same file in a future release

Build Elevate - v1.4.0

Structured Logging, RSC Pages & Changelog Site

Adds a shared structured logging package adopted across the API, converts the authenticated web pages to React Server Components for a faster first paint, and rebuilds the documentation changelog with an RSS feed and refreshed navigation.

Added

• Logger: New @workspace/logger package wrapping pino with env-based log level (LOG_LEVEL), sensitive-key redaction, and pino-pretty for local development — adopted across the API with pino-http per-request logging (health-check routes skipped, child logger on req.log) replacing morgan and ad-hoc console calls
• Docs: Rebuilt changelog page with color-coded entries grouped by change type, a /changelog/rss.xml feed, a reusable CopyButton and NPM brand icon, and Documentation/Changelog/NPM links in the shared nav
• Tooling: .markdownlint.yaml config for linting Markdown content

Changed

• Web: Converted the profile, dashboard, and settings (general/security/activity) pages to React Server Components that fetch the session server-side and pass data into client children — eliminating skeleton flash, useEffect form resets, and the activity data waterfall; added route-level loading/error boundaries and a shared requireUser() server guard
• Logger: Trust the first proxy hop in production so the real client IP is resolved for request logs

Removed

• Web: Dropped the now-unused /api/sessions route; sessions are fetched server-side via auth.api.listSessions

BuildElevate - v1.3.0

Overview

Adds Kubernetes support with deployment manifests, deploy/verify scripts, and an opt-in scaffolding flow, plus health probe endpoints. Also upgrades the GitHub Actions workflow and adds Turborepo caching across CI jobs.

Added

• Kubernetes: Kubernetes deployment manifests for the API and web apps — Namespace, ConfigMap, Deployments, ClusterIP Services, nginx Ingress with /api/v1/* rewrite, and HPAs (2–10 replicas)
• Kubernetes: deploy.sh to build/push images and apply all manifests, plus a CI-friendly k8s/verify.sh that health-checks pods, endpoints, in-cluster HTTP, ingress, and HPA metrics — exposed as k8s:deploy and k8s:verify pnpm scripts
• Kubernetes: /readyz and /healthz probe endpoints on the API server for Kubernetes liveness and readiness checks
• Kubernetes: Opt-in Kubernetes prompt during scaffolding (Docker-gated, defaults to No) with per-template manifest pruning and full upgrader integration
• Kubernetes: Kubernetes deployment guide added to the documentation site

Changed

• Kubernetes: Bake API_INTERNAL_URL into the web Docker image at build time so server-side rendering can reach the API in-cluster
• CI & Tooling: Upgraded the GitHub Actions workflow — actions/checkout, setup-node, and pnpm/action-setup to v6, Node.js 20 → 24, pnpm 10 → 11.1.1, and switched to the native setup-node pnpm cache

Fixed

• CI & Tooling: Stripped unnecessary quotes from DATABASE_URL values in .env.example files

Performance

• CI & Tooling: Added Turborepo cache restoration to the lint, type-check, test, and build CI jobs for faster pipeline runs