# Build with PhotonSpark

Deploy a website, ship a full-stack app, or bring a local service online with SparkTunnel. Guides for developers and the AI agents working with them.

Source: https://webhost.photonspark.com/docs

## Choose how your project runs

Start with the service you need to publish. A Site hosts one website origin. An App deploys a frontend and backend together. SparkTunnel keeps the application on your own machine.

- [Sites — static files, frontend builds, and Node servers](https://webhost.photonspark.com/docs/sites)
- [Apps — frontend, backend container, and shared PostgreSQL](https://webhost.photonspark.com/docs/apps)
- [SparkTunnel — publish a local service and download connectors](https://webhost.photonspark.com/docs/sparktunnel)

## From repository to public hostname

1. Prepare your project using the matching guide. Copy its AI prompt or use a Site starter to give your coding agent the deployment contract.
2. Sign in to Webhost to create a Site or App and select a hostname you control. Reading these docs and downloading clients do not require an account.
3. Configure DNS, connect the repository or upload a release, and add environment variables in the correct scope.
4. Deploy, then check build logs, runtime readiness, HTTPS, and your application's real routes.

- [Deployment workflow](https://webhost.photonspark.com/docs/deployments)
- [Domains and HTTPS](https://webhost.photonspark.com/docs/domains)

## Give your agent the same instructions

Every guide has a copyable AI prompt and a plain-text version. The Site guide also includes the same starter files used in the dashboard. Use placeholders for credentials; supply secrets through the dashboard or a protected local prompt.

- [Working with AI agents](https://webhost.photonspark.com/docs/agents)
- [Complete documentation as text](https://webhost.photonspark.com/docs/llms-full.txt)