Basic site

The smallest useful sitelo site: one page, one stylesheet, and host configs that publish dist/. Copy the configs into any sitelo project — they only assume npm run build → dist/.

A runnable copy lives in the sitelo repo under examples/basic/.

What you get

A one-page static site built with sitelo
netlify.toml, vercel.json, wrangler.toml, and amplify.yml
One-click / connect-repo deploy from the example folder

Project layout

my-site/
  sitelo.config.js
  netlify.toml           # Netlify
  vercel.json            # Vercel
  wrangler.toml          # Cloudflare Pages
  amplify.yml            # AWS Amplify
  package.json
  src/
    index.ht.js
    css/
      styles.css

export default () => `
  <html lang="en">
    <head>
      <title>sitelo — basic example</title>
      <link rel="stylesheet" href="/css/styles.css">
    </head>
    <body>
      <h1>Hello from sitelo</h1>
    </body>
  </html>
`

import { html, head, title, link, body, h1 } from 'javascript-to-html'

export default () =>
  html({ lang: 'en' },
    head(
      title('sitelo — basic example'),
      link({ rel: 'stylesheet', href: '/styles.css' }),
    ),
    body(h1('Hello from sitelo')),
  )

export default function Home() {
  return (
    <html lang="en">
      <head>
        <title>sitelo — basic example</title>
        <link rel="stylesheet" href="/css/styles.css" />
      </head>
      <body>
        <h1>Hello from sitelo</h1>
      </body>
    </html>
  )
}

Build

npm install
npm run build

Deploy

From the sitelo monorepo, set the platform’s root/base directory to examples/basic.

Netlify

[build]
  command = "npm run build"
  publish = "dist"

Vercel

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "framework": null,
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "installCommand": "npm install"
}

Deploy to Vercel · Deploy to Netlify (set base directory to examples/basic when prompted).

Cloudflare Pages

Dashboard: build command npm run build, output directory dist. Or npx wrangler pages deploy dist after a local build.

name = "sitelo-basic"
compatibility_date = "2025-01-01"
pages_build_output_dir = "dist"

AWS Amplify

Connect the repo in Amplify Hosting. For plain S3 + CloudFront, build locally and sync dist/ to the bucket.

version: 1
frontend:
  phases:
    preBuild:
      commands:
        - npm install
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: dist
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

Working with Cursor, Copilot, or another agent? Copy AGENTS.md from this example (or see Build with AI) so tools don’t invent React/Next patterns.

Getting started · Build with AI · Todo app · Server islands example