Deploy Notes

Use this document when deployment behavior or CI build commands are involved.

Expected deploy targets

This repository is structured so that at minimum these artifacts are deployable:

• docs site from apps/docs
• widgets app from apps/widgets

Build commands (workspace-safe)

From repository root:

pnpm build

Per workspace:

pnpm --filter docs docs:build
pnpm --filter grist-widget-examples build

Build ordering guarantees

turbo.json uses:

• build.dependsOn: ["^build"]
• test.dependsOn: ["^build"]

This ensures dependent apps build against freshly built upstream workspace packages such as @grist-widget-sdk/core.

Static hosting notes

• apps/widgets/public/_redirects enables SPA fallback routing for static hosting.
• apps/docs outputs static docs from VitePress to .vitepress/dist.

Agent checklist before touching deploy config

• Confirm workspace/package names still match commands.
• Confirm output paths used by hosting provider still match build output.
• Confirm no deploy instructions reference removed directories.