# Light Cloud

> Light Cloud is a deployment platform that enables developers to deploy applications (static sites and containers) and manage databases directly from GitHub repositories. Similar to Vercel or Netlify, but with support for both static hosting and containerized applications plus managed PostgreSQL databases.

Light Cloud provides an all-in-one platform for developers who want the simplicity of Vercel with the power of full-stack infrastructure. Deploy React apps, Node.js backends, and PostgreSQL databases from a single dashboard with GitHub integration, auto-deployments, and usage-based pricing.

## Documentation

- [LLMs Full Documentation](https://www.light-cloud.com/llms-full.txt): Complete Light Cloud documentation including all features, APIs, architecture, deployment guides, and configuration details
- [LLMs Medium Documentation](https://www.light-cloud.com/llms-medium.txt): Compressed documentation optimized for medium context windows, covering core concepts and essential configuration

## Platform Features

- [Static Deployments](https://console.light-cloud.com): Deploy React, Next.js, Vue, Angular, Svelte sites with global CDN
- [Container Deployments](https://console.light-cloud.com): Deploy Node.js, Python, Go, Java, Ruby, PHP, .NET applications
- [Managed Databases](https://console.light-cloud.com): PostgreSQL databases with automated provisioning and backups
- [GitHub Integration](https://console.light-cloud.com): OAuth connection and GitHub App for automatic deployments on push
- [Custom Domains](https://console.light-cloud.com): Automatic SSL certificate provisioning for custom domains

## GitHub Integration

### Features
- **Git Push Deployments**: Automatically deploy when you push to any branch
- **Preview Deployments**: Each branch gets its own environment URL (`{branch}-{app}-{org}.light-cloud.io`)
- **Auto-deploy on Push**: Enabled by default, configurable per application
- **Branch Environments**: Automatically create environments for new branches
- **Auto-cleanup**: Stale environments deleted when branches are deleted (production protected)

### Setup
1. Connect your GitHub account via OAuth
2. (Optional) Install GitHub App for organization-wide access
3. Select repository when creating application
4. Push code to trigger automatic deployments

### Auto-Deploy Settings
| Setting | Default | Description |
|---------|---------|-------------|
| Auto-deploy on push | On | Deploy when code is pushed |
| Auto-create branch environments | On | Create environment for new branches |
| Auto-delete stale environments | On | Delete when branch is deleted |

Note: Production environments (main/master branches) are never auto-deleted.

## Pricing

- **Platform Fee**: $9/user/month + usage
- **30-Day Free Trial**: Up to 3 resources, no credit card for first 2 weeks
- **Containers**: $0.06-$0.70/hour (scale-to-zero, pay only when running)
- **Databases**: $0.02-$0.46/hour (PostgreSQL)
- **Static Sites**: $0.039/GB storage + $0.21/GB bandwidth
- **Build Minutes**: $0.011/min
- [Full Pricing Details](https://www.light-cloud.com/pricing)

## Getting Started

- [Sign Up](https://console.light-cloud.com/signup): Create your account with GitHub or Google
- [Login](https://console.light-cloud.com): Access your dashboard
- [Documentation](https://www.light-cloud.com/llms-full.txt): Full platform documentation
- [Pricing](https://www.light-cloud.com/pricing): Transparent usage-based pricing

## Company

- [Website](https://www.light-cloud.com): Light Cloud homepage
- [About](https://www.light-cloud.com/about): About Light Cloud
- [Contact](https://www.light-cloud.com/contact): Contact us
- [Blog](https://blog.light-cloud.com): Latest updates and tutorials