static-site example #

View this page as Markdown

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": []
}