[UMBRELLA ☂️] ThunderID Installation Experience

[brionmario]

Overview

This issue tracks the ThunderID Developer Experience (DX) roadmap under the UMBRELLA initiative, with a focus on aligning ThunderID’s distribution and installation strategy with modern and trending developer adoption patterns.

The goal is to ensure ThunderID is accessible through the channels developers already use today, not just traditional installation methods.

🎯 Objective

Align ThunderID distribution and onboarding with modern developer workflows, including CLI-first, AI-assisted, package-based, and infrastructure-native installation options.

We aim to support a multi-channel adoption strategy that reduces friction and increases discoverability.

🚀 Target Distribution & Installation Channels

1. npx / CLI-first Experience

• npx create-thunderid-app style scaffolding
• Zero-install quickstart flows
• Interactive setup wizard (framework selection, auth config)
• Fast bootstrap for new projects
• Ideal for React / Node / Next.js developers

2. Skills-based Installation (AI Agent Skills)

• ThunderID packaged as agent skills
• Discoverable via AI tooling ecosystems
• Structured “skill definitions” for auth flows
• Reusable capabilities like:
  • login
  • token validation
  • session management
• Designed for AI-native developer workflows

3. Agent Plugins (Claude / Codex / AI IDEs)

• Plugin support for AI coding agents
• Prebuilt ThunderID integrations for:
  • authentication setup
  • route protection
  • SDK usage generation
• Optimized for tools like:
  • Claude
  • Codex-based agents
  • AI IDE assistants
• Goal: “Ask AI to add ThunderID auth” → works instantly

4. Homebrew Installation

• brew install thunderid-cli
• macOS/Linux developer support
• Lightweight CLI tooling distribution
• Versioned CLI updates via Homebrew formula
• Useful for backend / infra engineers

5. Traditional Package Downloads

• npm / pnpm / yarn SDK distribution
• Direct SDK usage in apps:
  • @thunderid/react
  • @thunderid/express
• Stable versioning strategy (LTS + latest)
• Backward compatibility guarantees

6. Docker-based Setup

• Prebuilt Docker images for ThunderID services/tools
• Local dev environment via:
  • docker run thunderid/auth-server
• Ideal for:
  • backend testing
  • isolated environments
  • CI pipelines
• Optional full-stack dev containers

7. Helm Charts (Kubernetes Deployment)

• Production-grade deployment via Helm
• helm install thunderid
• Configurable identity service setup
• Supports:
  • multi-tenant environments
  • scaling policies
  • secret management integration
• Target audience: DevOps / platform engineers

🧭 Strategic Goals

• Reduce onboarding time to < 5 minutes
• Meet developers where they already are (CLI, AI tools, cloud-native)
• Provide consistent ThunderID experience across all channels
• Enable both local dev simplicity and enterprise-grade deployment

📦 Expected Outcomes

• Unified distribution strategy across ecosystems
• Increased adoption through AI-native and CLI-first workflows
• Strong enterprise readiness via Docker + Helm
• Improved developer satisfaction and reduced setup friction

🔗 Related Areas

• ThunderID SDK ecosystem
• ThunderID CLI tooling
• ThunderID samples repository
• ThunderID.dev documentation platform