SparkStack — Next.js on Google Cloud Run
A modern, containerized architecture for private, high-performance AI workflows. SparkStack runs your Next.js app as a lightweight container on Google Cloud Run — giving you instant SSR, predictable scaling, and full control over runtime environment and dependencies.
Modern deployment stack
Containerized
Built as a standalone Node container for Cloud Run.
Secure Auth
Firebase Authentication for user identity and sessions.
Fast SSR
Server-side rendering with minimal client overhead.
Scalable
Automatic, per-request scaling on Cloud Run.
How it fits together
SparkStack compiles Next.js into a production-ready standalone app, packages it into a container, and deploys it to Google Cloud Run. Optionally, Firebase Hosting can act as a proxy or provide static hosting. This gives you the best of both worlds: a modern SSR experience with the operational simplicity of serverless containers.
gcloud builds submit --tag gcr.io/<PROJECT>/sparkstack && gcloud run deploy sparkstack
Database
SparkStack uses Prisma as the application ORM and migrations system with PostgreSQL as the primary relational database. In production we recommend a managed Postgres instance (for example Cloud SQL on GCP) and running migrations from your CI/CD pipeline.
Migrations live in the prisma/migrations folder. To apply migrations locally or in CI, run the Prisma migrate commands or use a deploy script that callsnpx prisma migrate deploy against your database URL. The project also includes helper scripts in the scripts/ directory for setup and testing.
npx prisma migrate deploy