Configuration

Project Configuration

Use shape.toml for project-level configuration.

Main sections:

• [project] — package metadata and entrypoint
• [modules] — module search paths
• [dependencies] — path, git, and bundle dependencies
• [[extensions]] — runtime extension modules
• [build] — build target and optimization
• [build.external] — lockflow refresh policy
• Custom extension sections (e.g., [native-dependencies])

See Projects & shape.toml and Packages & Building.

Standalone Script Configuration

Use frontmatter (---) for standalone scripts.

See Script Frontmatter.

Server Ports (Book + Execution Backend)

• Book UI (Astro Starlight): 9090
• shape-server: 9091

Book JavaScript resolves backend endpoint in this order:

1. window.__SHAPE_BOOK_API_BASE
2. <meta name="shape-api-base" content="...">
3. localStorage['shape.apiBase']
4. default http(s)://<host>:9091

Environment Variables

shape-server

• SHAPE_SERVER_PORT - override default backend port (9091)
• SHAPE_LSP_PATH - path to shape-lsp binary

Runtime/Tooling

• Runtime/tooling configuration is project-local (shape.toml) or script-local (frontmatter).