Skip to content
StackSolo

Introduction

StackSolo is an open source CLI tool that helps solo developers deploy cloud infrastructure without learning Terraform or clicking through cloud consoles.

What is StackSolo?

Section titled “What is StackSolo?”

You write a simple JSON config file describing what you want:

{
  "project": {
    "name": "my-app",
    "gcpProjectId": "my-gcp-project",
    "region": "us-central1",
    "networks": [{
      "name": "main",
      "functions": [{ "name": "api" }],
      "uis": [{ "name": "web" }]
    }]
  }
}

Then run stacksolo deploy, and StackSolo:

  1. Generates real Terraform/CDKTF code
  2. Creates all the GCP resources
  3. Outputs URLs and connection strings

Key Points

Section titled “Key Points”
  • Open source - MIT licensed, community driven
  • Runs locally - No SaaS, no accounts, no vendor lock-in
  • Generates real code - You can audit and eject anytime
  • Plugin-based - Extend with your own resources

What Can You Build?

Section titled “What Can You Build?”

StackSolo helps you deploy common patterns on Google Cloud:

PatternResources Created
APICloud Function + Load Balancer
Full StackFunction + Static Site + Database
MicroservicesMultiple Cloud Run containers
Event-DrivenFunctions + Pub/Sub topics

Start From a Stack

Section titled “Start From a Stack”

Don’t want to start from scratch? Clone a pre-built stack:

Terminal window
# List available stacks
npx stacksolo clone --list


# Clone a complete application
npx stacksolo clone rag-platform my-chatbot

Stacks are complete, deployable applications with full source code, infrastructure config, and documentation.

How It Works

Section titled “How It Works”
Your Config → StackSolo → Terraform/CDKTF → GCP Resources
  1. You write stacksolo.config.json
  2. StackSolo generates infrastructure code
  3. Terraform deploys to GCP
  4. You get working URLs

The generated code lives in .stacksolo/cdktf/ - you own it completely.

Next Steps

Section titled “Next Steps”