Docs

Everything you need to build a site with SpiderCaster 0.1.0, from the first install to a folder of pages on your own host. Every command on these pages was run against version 0.1.0, and every result shown is what it printed.

One build, start to finish

This is what an offline build prints. Zero requests, zero cost, and the next two commands to run.

build output
$ python spidercaster.py build projects/my-site --offline --out sites/my-site
built sites/my-site (mode: offline)
  pages: index.html, favicon.svg
  tokens: requests=0 ok=0 in=0 out=0 est_cost=$0.0000
  index: NOINDEX (default; pass --indexable to flip)
  robots: sites/my-site/robots.txt
  next: python spidercaster.py check sites/my-site
        python spidercaster.py serve sites/my-site

Exit code: 0

Start here

New to SpiderCaster? These three guides take you from nothing to a checked draft on your own computer.

Install guide

Get SpiderCaster with one command, check the setup with the doctor, and open the studio desk.

First site in 5 minutes

Write a few lines, build the draft, check it, and preview it. No keys, zero tokens.

Project layout

What goes in a project folder, and what every build writes next to the pages.

Learn how it works

Once the first draft is built, these guides explain what the engine did and how to change it.

Molds, frames, and seats

The whole-site starting points, the section recipes, and the seven seats that plan a site.

Config reference

Every field of site.json, the record of a build that you can edit and rebuild at zero tokens.

Commands

Every command in version 0.1.0, with its flags and what it prints.

Check and ship

A draft is only finished when it passes the gate. Then it is a folder of plain files that any web host can serve.

Check gate

What the checker reads on every page, and why one failure stops the job.

Deploy to static hosting

Copy plain files to any host. No server code, no database, no login to keep up.

AI is optional

The AI path is off until you turn it on. Free models come first, and paid models run only when you allow them.

FAQ

Short answers to the questions people ask first.

Two rules behind every page

SpiderCaster never invents words. Every headline, card, and answer on a built page comes from your brief and the files in your copy folder, and the checker fails a page that shows a line it cannot find there.

Drafts stay out of search. Every build is noindex until you rebuild it with the indexable flag, so nothing reaches search results before a person has read the words.