# 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

### Features
- **Git Push Deployments**: Deploy automatically on every push
- **Preview Deployments**: Each branch gets unique URL
- **OAuth**: Connect personal GitHub account
- **GitHub App**: Organization-wide access for teams

### Auto-Deploy Settings
| Setting | Default |
|---------|---------|
| Auto-deploy on push | On |
| Auto-create branch environments | On |
| Auto-delete stale environments | On |

Production branches (main/master) never auto-deleted.

### Workflow
1. Push to branch → Auto-deploy triggered
2. New branch → Environment auto-created
3. Branch deleted → Environment auto-cleaned

## 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

Full pricing: https://www.light-cloud.com/pricing

### Platform Fee
$9/user/month + infrastructure usage

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

### Container Pricing (per hour)
| Size | vCPU | Memory | Price/hr | ~Monthly |
|------|------|--------|----------|----------|
| Nano | 1 | 256MB | $0.06 | ~$46 |
| Micro | 1 | 512MB | $0.06 | ~$47 |
| Small | 1 | 1GB | $0.07 | ~$49 |
| Medium | 2 | 2GB | $0.13 | ~$98 |
| Large | 4 | 4GB | $0.27 | ~$197 |
| X-Large | 8 | 8GB | $0.54 | ~$394 |
| 2X-Large | 8 | 16GB | $0.59 | ~$433 |
| 3X-Large | 8 | 32GB | $0.70 | ~$510 |

Scale-to-zero: Pay only when running. Tier 2 regions +20%.

### Database Pricing (per hour)
| Tier | vCPU | RAM | Price/hr | ~Monthly |
|------|------|-----|----------|----------|
| Dev | Shared | 0.6GB | $0.02 | ~$13 |
| Starter | Shared | 1.7GB | $0.05 | ~$38 |
| Pro | 1 | 4GB | $0.11 | ~$83 |
| Business | 2 | 8GB | $0.23 | ~$166 |
| Enterprise | 4 | 16GB | $0.46 | ~$332 |

+ Storage: $0.17/GB/month. HA: 2× compute.

### Static Sites
- Storage: $0.039/GB/month
- Bandwidth: $0.21/GB

### Build Minutes
$0.011/minute

## 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