static-site example #
On this page
A static site with one page and its stylesheet, served without a server of its own.
These files come from the same source as the scaffold command. They are the whole site as written; the command installs nothing.
With a shell #
This template needs no Turn Zero sign-in or token and downloads no library package. Run this in a new project's root:
turnzero scaffold --template static-site
Follow the command's next steps. It writes the application in app/, without installing dependencies or running tests. The turnzero command explains setup and options.
From a chat #
A Cloud tool name without a prefix is its HTTP API name; your MCP connection lists it with tzcloud_ before it. The copied AGENTS.md instructions below use the names listed by the MCP connection.
Follow Publish a static site. Create a serverless application and submit its manifest with submit_manifest before the first deploy. Read the files below and send the application files through deploy_files.
The scaffold can bind its manifest to an application with --application <application id>. From a chat, name the application explicitly in submit_manifest and deploy_files. The platform uses the application named in the call and checks an uploaded manifest's optional application ID only for lowercase UUID form. turnzero deploy and turnzero check refuse a folder whose manifest names another application.
Keep the application paths shown in the table. The download URLs end in .txt so a browser reads the code instead of running it; that suffix is not part of the application filename. Each file is also reproduced below for tools reading this page through MCP.
Files #
Paths are relative to the application root, the folder containing manifest.json and client/. deploy_files uses these paths without an app/ prefix.
| Application path | Read source |
|---|---|
.gitignore |
Text |
AGENTS.md |
Text |
client/index.html |
Text |
client/styles.css |
Text |
manifest.json |
Text |
File contents #
.gitignore #
node_modules/
.env
.env.*
AGENTS.md #
# This service runs on Turn Zero Cloud
The service in this folder is hosted on Turn Zero Cloud. It started from the platform's `static-site` template: a static site whose pages, styles and other files are served without a server of the application's own. This file describes the template the service started from: keep it current as the service changes.
## Where you build
- Edit the files under `client/`.
- A file's path below `client/` is its path on the site; `/` serves `client/index.html`.
## Where the rules are
Turn Zero Cloud serves its rules to a coding tool through the MCP server `turnzero`, one connection to the products your account holds. The rules change with the platform, so none is repeated here.
- Where the server is not connected, set up Turn Zero Cloud first: https://turnzero.ai/cloud/getting-started/set-up/
- Before you change or deploy this service, read the server's `deploy` skill.
## What you run here
- A local run and a deploy: the `deploy` skill gives each step and the line to run, in this order: `tzcloud_submit_manifest`, the local run, `tzcloud_deploy_command`.
- Read Publish a static site through `read_documentation` at `/cloud/guides/publish-a-static-site/`.
client/index.html #
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Static site</title>
<link rel="stylesheet" href="styles.css">
</head>
<body>
<main>
<h1>Your static site</h1>
<p>Turn Zero Cloud serves this page from <code>client/index.html</code>. Its styles come from <code>client/styles.css</code>.</p>
</main>
</body>
</html>
client/styles.css #
/* client/styles.css, which client/index.html links beside it */
:root {
color-scheme: light dark;
font-family: system-ui, sans-serif;
line-height: 1.5;
}
body {
margin: 0 auto;
max-width: 40rem;
padding: 2rem 1rem;
}
h1 {
font-size: 1.75rem;
margin: 0 0 1rem;
}
code {
font-family: ui-monospace, monospace;
}
manifest.json #
{
"manifest_version": 1,
"services": [],
"region": "usa",
"egress": [],
"audience": { "kind": "public" },
"packages": []
}