# Light Cloud - Documentation (Medium)

> Deployment platform for static sites, containers, and databases from GitHub. Vercel-like simplicity with full-stack capabilities.

## Quick Start

- **Sign Up**: https://console.light-cloud.com/signup
- **Login**: https://console.light-cloud.com
- **API**: https://api.light-cloud.com

## Supported Frameworks & Runtimes

### Static Frameworks
React, Next.js (static), Vue, Angular, Svelte, Plain HTML

### Container Runtimes
Node.js, Python, Go, Java, Ruby, PHP, .NET, Custom Dockerfile

### Full-Stack Frameworks by Runtime
- **Node.js**: Next.js SSR, Nuxt, Remix, Express, Fastify, NestJS, Koa, Hono, AdonisJS
- **Python**: Django, Flask, FastAPI, Starlette, Tornado
- **Go**: Gin, Fiber, Echo, Chi
- **Ruby**: Rails, Sinatra, Hanami
- **PHP**: Laravel, Symfony, Slim
- **Java**: Spring Boot, Quarkus, Micronaut
- **.NET**: ASP.NET Core, Minimal APIs

## Deployment Types

### Static Sites
- Frameworks: React, Next.js (static), Vue, Angular, Svelte, HTML
- Hosting: Global CDN with edge caching
- Pricing: ~$0.039/GB storage, ~$0.21/GB bandwidth

### Containers
- Runtimes: Node.js, Python, Go, Java, Ruby, PHP, .NET
- Any framework that runs on supported runtimes works
- Hosting: Managed containers with auto-scaling
- Memory: 256MB-32GB, CPU: 1-8 vCPU
- Scale-to-zero by default
- Pricing: ~$0.06-$0.70/hour

### Databases (PostgreSQL)
- Tiers: Dev, Starter, Pro, Business, Enterprise
- Automated provisioning
- Pricing: ~$0.02-$0.46/hour

## GitHub Integration

- OAuth for repository access
- GitHub App for auto-deployments
- Auto-deploy on push
- Auto-create branch environments
- Auto-delete stale environments
- Production branches protected

## Subdomains

Format: `{branch}-{app}-{org}.light-cloud.io`

Example: `main-myapp-acme.light-cloud.io`

Custom domains supported with automatic SSL.

## Environment Variables

Merged in order (lowest to highest priority):
1. Application defaults
2. Environment-specific overrides

## API Endpoints

### Applications
- `POST /api/applications` - List
- `POST /api/applications/create` - Create
- `POST /api/applications/get` - Get one
- `POST /api/applications/update` - Update
- `POST /api/applications/delete` - Delete

### Environments
- `POST /api/environments/create` - Create
- `POST /api/environments/deploy` - Deploy
- `POST /api/environments/update` - Update
- `POST /api/environments/delete` - Delete

## Status States

| Status | Description |
|--------|-------------|
| pending | Created, not deployed |
| queued | In deployment queue |
| deploying | Build in progress |
| deployed | Live and accessible |
| failed | Deployment failed |

## Roles & Permissions

| Role | Billing | Create | Delete | Invite |
|------|---------|--------|--------|--------|
| Owner | Manage | Yes | Yes | Yes |
| Admin | View | Yes | Yes | Yes |
| User | No | No | No | No |

## Pricing

### Free Trial
- 30 days, up to 3 resources
- No credit card for first 2 weeks

### Container Pricing (per hour)
| Memory | Price |
|--------|-------|
| 256MB | ~$0.06 |
| 512MB | ~$0.06 |
| 1GB | ~$0.07 |
| 2GB | ~$0.13 |
| 4GB | ~$0.27 |

### Database Pricing (per hour)
| Tier | Price |
|------|-------|
| Dev | ~$0.02 |
| Starter | ~$0.05 |
| Pro | ~$0.11 |
| Business | ~$0.23 |

## Next.js Support

- `output: "export"` → Static (Global CDN)
- Default or API routes → Container (Managed)

## Auto-Deploy Settings

| Setting | Default |
|---------|---------|
| autoDeployOnPush | true |
| autoDeployBranches | true |
| autoDeleteStaleEnvs | true |

## Memory/CPU Compatibility

| Memory | CPU Range |
|--------|-----------|
| 512Mi-1Gi | 1-2 |
| 2Gi-4Gi | 1-4 |
| 8Gi | 2-8 |
| 16Gi | 4-8 |

## Real-Time Updates

Socket.IO rooms:
- `env:{envId}` - Deployment progress
- `app:{appId}` - Environment changes

## Quick Start Tutorials

### Deploy Static Site
1. Sign up at https://console.light-cloud.com/signup
2. Connect GitHub account
3. Click "New Application" → Select repo
4. Framework auto-detected (React, Vue, Next.js, etc.)
5. Click "Create" → "Deploy"
6. Live at `main-{app}-{org}.light-cloud.io`

### Deploy Backend API
1. Create application → Select "Container"
2. Runtime auto-detected (Node.js, Python, Go)
3. Set port (default 8080) and memory (512MB+)
4. Add environment variables (DATABASE_URL, etc.)
5. Deploy → API live at subdomain

### Deploy Full-Stack (Frontend + Backend + DB)
1. **Database**: Create PostgreSQL → Copy connection string
2. **Backend**: Create container app → Add DATABASE_URL → Deploy
3. **Frontend**: Create static app → Add VITE_API_URL → Deploy
4. Configure CORS on backend for frontend domain

### Next.js SSR
- API routes detected → Deploys as container automatically
- `output: "export"` → Deploys as static
- Environment variables set in Settings

### Preview Environments
- Push new branch → Auto-creates environment
- URL: `{branch}-{app}-{org}.light-cloud.io`
- Branch deleted → Environment auto-cleaned

## Security

- DDoS protection (automatic)
- Web Application Firewall (WAF)
- Bot management & rate limiting
- SSL/TLS with TLS 1.3
- HTTP/2 & HTTP/3 support
- IP reputation blocking
- Geo-blocking (optional)
- JWT authentication
- Webhook signature validation

## Key Differentiators

1. Full-stack: static + containers + databases
2. Scale-to-zero containers
3. Usage-based pricing
4. GitHub-native workflows
5. Simpler than raw cloud

## Links

- Website: https://www.light-cloud.com
- Console: https://console.light-cloud.com
- Blog: https://blog.light-cloud.com
- About: https://www.light-cloud.com/about
- Contact: https://www.light-cloud.com/contact