> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shardcloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Applications

> ShardCloud provides a comprehensive hosting platform designed for modern web applications. Our infrastructure supports various deployment scenarios with enterprise-grade features accessible to developers of all levels.

<CardGroup cols={2}>
  <Card title="Custom Domains" icon="globe" href="#custom-domains">
    Integrate your own branded domain on our platform
  </Card>

  <Card title="Free Subdomains" icon="link" href="#subdomains">
    Get instant \*.shardweb.app domains for every app
  </Card>

  <Card title="GitHub Integration" icon="github" href="#github-deployment">
    Automatic deployments from your repositories
  </Card>

  <Card title="Auto Recovery" icon="s" href="#auto-restart">
    Intelligent application restart system
  </Card>
</CardGroup>

## Production-Optimized Containers

<CardGroup cols={2}>
  <Card title="Language-Specific Containers" icon="docker">
    Optimized containers for each supported language
  </Card>

  <Card title="Production Hardening" icon="shield">
    Security and performance optimizations built-in every app
  </Card>
</CardGroup>

Our container environments are specifically designed and optimized for production workloads, ensuring your applications run efficiently and securely.

**Container Features:**

* **Minimal Base Images**: Reduced attack surface and faster startup times
* **Multi-Stage Builds**: Optimized build processes for smaller final images
* **Security Hardening**: Regular security updates and vulnerability patches
* **Performance Tuning**: Language-specific optimizations and configurations
* **Resource Limits**: Configurable CPU and memory limits

### Supported Languages:

* [Node](/languages/javascript)
* [Python](/languages/python)
* [Golang](/languages/go)
* [C#](/languages/csharp)
* [Ruby](/languages/ruby)
* [Elixir](/languages/elixir)
* [Static html (nginx)](/languages/static)
* [Php](/languages/php)
* [Java](/languages/java)

You can find examples of how to host your projects in each language under the **Languages** section.

## Custom Domains

Our custom domain system allows you to maintain your brand identity while leveraging our robust hosting infrastructure. Simply point your DNS records to our servers, and we'll handle the rest.

**Key Features:**

* SSL certificates automatically provisioned and renewed
* DNS management assistance
* Subdomain support (www, api, staging, etc.)

<Steps>
  <Step title="Add Domain">
    Navigate to your app network settings and add your custom domain
  </Step>

  <Step title="Configure DNS">
    Point your domain's CNAME to our provided endpoints
  </Step>

  <Step title="Verify Setup">
    Our system automatically verifies and provisions SSL certificates
  </Step>
</Steps>

## Free Subdomains

<Tip>
  Every application gets a free `xyz.shardweb.app` subdomain instantly upon creation.
</Tip>

Our subdomain system provides immediate access to your applications without any setup required. Perfect for development, staging, or production environments.

**Benefits:**

* Instant availability upon app creation
* No configuration required
* SSL enabled by default
* Easy to remember naming convention
* Perfect for API endpoints and microservices

## GitHub Integration & Automatic Deployment

<Warning>
  Ensure your repository has the correct build configuration before connecting for optimal deployment experience.
</Warning>

Our platform seamlessly integrates with GitHub repositories, enabling continuous deployment workflows that keep your applications up-to-date with every commit.

**Deployment Features:**

* **Automatic Builds**: Triggered on every push to your master/main branch
* **Deploy history**: See the entire deploy history of your application
* **Webhook Integration**: Custom webhooks for external integrations

## Auto Restart System

<Note>
  Our intelligent restart system monitors your application health and automatically recovers from crashes.
</Note>

The auto-restart feature ensures maximum uptime for your applications through intelligent monitoring and recovery mechanisms.

**How It Works:**

1. **Health Monitoring**: Continuous monitoring of application processes
2. **Automatic Recovery**: Up to 3 restart attempts within a short time period
3. **Circuit Breaker**: Applications stop after limit is reached to prevent resource waste
4. **Reset Timer**: Restart limits refresh automatically after cooldown period

**Restart Triggers:**

* Process crashes or exits unexpectedly
* Memory limit exceeded
* Health check failures

## Real-Time Metrics & Analytics

<CardGroup cols={2}>
  <Card title="Resource Metrics" icon="microchip">
    CPU, Memory, and Network usage in real-time
  </Card>

  <Card title="HTTP Metrics" icon="chart-line">
    Response times, status codes, RPS, and geographic distribution
  </Card>
</CardGroup>

Our metrics dashboard provides comprehensive insights into your application's performance with beautiful, easy-to-understand visualizations.

**Resource Metrics:**

* **CPU & RAM**: Real-time utilization tracking
* **Network Traffic**: Incoming and outgoing bandwidth
* **Uptime Statistics**: Historical uptime percentages

### HTTP Metrics

Every application with an exposed endpoint gets detailed HTTP analytics out of the box — no SDK or instrumentation required.

<Frame caption="Request rate, response times, and traffic overview">
  <img src="https://mintcdn.com/shardcloud/AvyJzJ1vxNhV6xtW/images/metrics_1.jpg?fit=max&auto=format&n=AvyJzJ1vxNhV6xtW&q=85&s=be29fe4fd72732c35ec0e8102b4d1441" width="1306" height="815" data-path="images/metrics_1.jpg" />
</Frame>

<Frame caption="Geographic distribution and status code breakdown">
  <img src="https://mintcdn.com/shardcloud/AvyJzJ1vxNhV6xtW/images/metrics_2.jpg?fit=max&auto=format&n=AvyJzJ1vxNhV6xtW&q=85&s=a0ffd3d23dfeb6a403c36b74347c1d23" width="1394" height="806" data-path="images/metrics_2.jpg" />
</Frame>

<Frame caption="Requests by route, status distribution, and browser breakdown">
  <img src="https://mintcdn.com/shardcloud/Eji6iA0inBKmrLJ-/images/metrics_3.jpg?fit=max&auto=format&n=Eji6iA0inBKmrLJ-&q=85&s=75db7dd2fb9571898b667d30063791cd" width="1432" height="812" data-path="images/metrics_3.jpg" />
</Frame>

**Available HTTP Metrics:**

* **Response Time**: Average, minimum, and maximum response times over time
* **Status Codes**: Distribution of 2xx, 4xx, and 5xx responses
* **Requests Per Second (RPS)**: Live request rate tracking
* **Requests Per Route**: Traffic breakdown by individual endpoint
* **Requests Per Browser**: User-agent and device type distribution across your traffic
* **Requests By Country/Region**: Geographic map showing where your traffic originates

### HTTP Request Logs

Every incoming HTTP request is automatically logged — no custom logging middleware needed. Each log entry captures the route, status code, response time, and client information, giving you full visibility into your traffic without writing a single line of logging code.

## Real-Time Logs

<Tip>
  Access your application logs instantly without SSH or complex setup procedures.
</Tip>

Our logging system captures all application output in real-time, making debugging and monitoring effortless.

**Log Features:**

* **Live Tail**: Stream logs in real-time as they happen
* **Search & Filter**: Find specific log entries quickly

### Crash & Restart Logging

Every time your application crashes or restarts, we automatically create a snapshot of the current logs, preserving crucial debugging information that might otherwise be lost.

## Backup & Snapshot System

<Info>
  Protect your application data with automated backups and instant recovery options.
</Info>

Our backup system ensures your application data is always safe with multiple recovery points available.

**Backup Features:**

* **Manual Backups**: Up to 10 backups per application
* **Instant Recovery**: One-click restoration to any backup point
* **Incremental Backups**: Efficient storage using delta compression

<Steps>
  <Step title="Easy Creation">
    Backups are created with only one click
  </Step>

  <Step title="Browse Snapshots">
    View all available backups with timestamps and size information
  </Step>

  <Step title="Instant Restore">
    Click to restore any backup point with zero downtime
  </Step>
</Steps>

## Integrated File Manager

Access and manage your application files directly from your dashboard.

**File Manager Capabilities:**

* **Real-Time File Browsing**: Navigate your application directory structure
* **Inline Editing**: Edit configuration files directly in the browser
* **File Upload/Download**: Transfer files to and from your application
* **File tools**: Rename/move files in real time

### Supported Operations

* Create, rename, and delete files and directories
* Copy and move files between directories
* View file properties and metadata
* Search for files and content within files

## Custom Dependency Manager

<Tip>
  Our dependency manager automatically detects your project type and suggests optimal configurations.
</Tip>

Simplify dependency management with our intelligent system that understands your application's requirements.

**Supported Package Managers:**

* **Node.js**: npm, yarn, pnpm
* **Python**: pip
* **PHP**: composer
* **Go**: go modules
* **Java**: maven, gradle

**Features:**

* **Automatic Detection**: Recognizes package files and install them
* **Cache Optimization**: Intelligent caching for faster startup times