spacefn-docs 0.0.0-stage → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +200 -0
- package/README.md +15 -2
- package/assets/reader.css +1131 -0
- package/assets/reader.js +324 -0
- package/content/1-getting-started.md +107 -0
- package/content/2-conventions.md +138 -0
- package/content/3-best-practices.md +68 -0
- package/content/4-folders/1-app/1-entry.md +48 -0
- package/content/4-folders/1-app/2-routes.md +92 -0
- package/content/4-folders/1-app/3-db.md +81 -0
- package/content/4-folders/1-app/4-queues.md +46 -0
- package/content/4-folders/1-app/5-crons.md +30 -0
- package/content/4-folders/1-app/6-assets.md +53 -0
- package/content/4-folders/1-app/7-durable-objects.md +60 -0
- package/content/4-folders/1-app/8-workflows.md +46 -0
- package/content/4-folders/1-app/index.md +43 -0
- package/content/4-folders/2-modules.md +71 -0
- package/content/4-folders/3-lib.md +60 -0
- package/content/4-folders/4-public.md +24 -0
- package/content/4-folders/5-docs.md +23 -0
- package/content/4-folders/6-configs.md +57 -0
- package/content/4-folders/7-space.md +34 -0
- package/content/4-folders/8-env.md +34 -0
- package/content/4-folders/9-package-json.md +37 -0
- package/content/4-folders/index.md +50 -0
- package/content/5-deployment/1-cloudflare.md +56 -0
- package/content/5-deployment/2-bun.md +68 -0
- package/content/5-deployment/3-infrastructure.md +67 -0
- package/content/5-deployment/4-ci-cd.md +131 -0
- package/content/5-deployment/index.md +48 -0
- package/content/6-guides/1-entry.md +113 -0
- package/content/6-guides/2-routes.md +162 -0
- package/content/6-guides/3-pages.md +148 -0
- package/content/6-guides/4-frontend.md +232 -0
- package/content/6-guides/5-database.md +178 -0
- package/content/6-guides/6-services.md +125 -0
- package/content/6-guides/7-jobs.md +61 -0
- package/content/6-guides/8-auth.md +111 -0
- package/content/6-guides/9-testing.md +70 -0
- package/content/6-guides/index.md +21 -0
- package/content/7-reference/1-config.md +67 -0
- package/content/7-reference/2-cli.md +27 -0
- package/content/7-reference/3-writing-docs.md +206 -0
- package/content/7-reference/index.md +15 -0
- package/content/index.md +49 -0
- package/content/logo.svg +12 -0
- package/dist/index.d.mts +72 -0
- package/dist/index.mjs +713 -0
- package/examples/README.md +18 -0
- package/examples/datastar/.env.example +2 -0
- package/examples/datastar/README.md +17 -0
- package/examples/datastar/app/assets/main.ts +4 -0
- package/examples/datastar/app/assets/site.css +3 -0
- package/examples/datastar/app/db/main/config.json +5 -0
- package/examples/datastar/app/db/main/migrations/0001_votes.sql +8 -0
- package/examples/datastar/app/db/main/queries/add-vote.sql +3 -0
- package/examples/datastar/app/db/main/queries/tally.sql +1 -0
- package/examples/datastar/app/entry.ts +28 -0
- package/examples/datastar/app/routes/_middleware.ts +4 -0
- package/examples/datastar/app/routes/health.ts +7 -0
- package/examples/datastar/app/routes/index.ts +43 -0
- package/examples/datastar/configs/env.ts +6 -0
- package/examples/datastar/configs/infra.ts +85 -0
- package/examples/datastar/configs/tsconfig.json +15 -0
- package/examples/datastar/configs/vite.ts +4 -0
- package/examples/datastar/configs/vitest.ts +9 -0
- package/examples/datastar/lib/types/rocket.d.ts +30 -0
- package/examples/datastar/lib/ui/base.css +17 -0
- package/examples/datastar/lib/ui/layout.ts +27 -0
- package/examples/datastar/modules/poll/client/poll-meter.ts +39 -0
- package/examples/datastar/modules/poll/poll.css +13 -0
- package/examples/datastar/modules/poll/poll.test.ts +48 -0
- package/examples/datastar/modules/poll/poll.ts +62 -0
- package/examples/datastar/modules/poll/views.ts +52 -0
- package/examples/datastar/package.json +33 -0
- package/examples/datastar/tsconfig.json +4 -0
- package/examples/lightningcss/.env.example +1 -0
- package/examples/lightningcss/README.md +15 -0
- package/examples/lightningcss/app/assets/site.css +3 -0
- package/examples/lightningcss/app/entry.ts +28 -0
- package/examples/lightningcss/app/routes/_middleware.ts +4 -0
- package/examples/lightningcss/app/routes/health.ts +7 -0
- package/examples/lightningcss/app/routes/index.ts +12 -0
- package/examples/lightningcss/configs/Dockerfile +26 -0
- package/examples/lightningcss/configs/Dockerfile.dockerignore +9 -0
- package/examples/lightningcss/configs/env.ts +4 -0
- package/examples/lightningcss/configs/infra.ts +55 -0
- package/examples/lightningcss/configs/tsconfig.json +15 -0
- package/examples/lightningcss/configs/vite.ts +19 -0
- package/examples/lightningcss/configs/vitest.ts +9 -0
- package/examples/lightningcss/lib/ui/layout.ts +17 -0
- package/examples/lightningcss/lib/ui/tokens.css +23 -0
- package/examples/lightningcss/modules/releases/releases.css +20 -0
- package/examples/lightningcss/modules/releases/releases.test.ts +18 -0
- package/examples/lightningcss/modules/releases/releases.ts +21 -0
- package/examples/lightningcss/modules/releases/views.ts +25 -0
- package/examples/lightningcss/package.json +33 -0
- package/examples/lightningcss/tsconfig.json +4 -0
- package/examples/mini-shopify/.env.example +6 -0
- package/examples/mini-shopify/README.md +19 -0
- package/examples/mini-shopify/app/assets/site.css +2 -0
- package/examples/mini-shopify/app/db/platform/config.json +5 -0
- package/examples/mini-shopify/app/db/platform/migrations/0001_shops.sql +10 -0
- package/examples/mini-shopify/app/db/platform/queries/add-shop.sql +4 -0
- package/examples/mini-shopify/app/db/platform/queries/find-shop.sql +3 -0
- package/examples/mini-shopify/app/db/platform/queries/list-shops.sql +1 -0
- package/examples/mini-shopify/app/db/shop/config.json +6 -0
- package/examples/mini-shopify/app/db/shop/migrations/0001_products.sql +11 -0
- package/examples/mini-shopify/app/db/shop/queries/add-product.sql +4 -0
- package/examples/mini-shopify/app/db/shop/queries/list-products.sql +1 -0
- package/examples/mini-shopify/app/db/shop/queries/sell-product.sql +2 -0
- package/examples/mini-shopify/app/entry.ts +25 -0
- package/examples/mini-shopify/app/routes/_middleware.ts +4 -0
- package/examples/mini-shopify/app/routes/health.ts +7 -0
- package/examples/mini-shopify/app/routes/index.ts +26 -0
- package/examples/mini-shopify/app/routes/s/[shop]/_middleware.ts +6 -0
- package/examples/mini-shopify/app/routes/s/[shop]/index.ts +32 -0
- package/examples/mini-shopify/configs/Dockerfile +26 -0
- package/examples/mini-shopify/configs/Dockerfile.dockerignore +9 -0
- package/examples/mini-shopify/configs/env.ts +14 -0
- package/examples/mini-shopify/configs/infra.ts +55 -0
- package/examples/mini-shopify/configs/tsconfig.json +15 -0
- package/examples/mini-shopify/configs/vite.ts +4 -0
- package/examples/mini-shopify/configs/vitest.ts +9 -0
- package/examples/mini-shopify/lib/ui/base.css +19 -0
- package/examples/mini-shopify/lib/ui/layout.ts +17 -0
- package/examples/mini-shopify/modules/catalog/catalog.ts +31 -0
- package/examples/mini-shopify/modules/catalog/views.ts +39 -0
- package/examples/mini-shopify/modules/shops/host.test.ts +38 -0
- package/examples/mini-shopify/modules/shops/host.ts +73 -0
- package/examples/mini-shopify/modules/shops/shops.test.ts +63 -0
- package/examples/mini-shopify/modules/shops/shops.ts +64 -0
- package/examples/mini-shopify/modules/shops/views.ts +28 -0
- package/examples/mini-shopify/package.json +35 -0
- package/examples/mini-shopify/tsconfig.json +4 -0
- package/examples/react/.env.example +2 -0
- package/examples/react/README.md +18 -0
- package/examples/react/app/assets/site.css +3 -0
- package/examples/react/app/entry.ts +28 -0
- package/examples/react/app/routes/_middleware.ts +4 -0
- package/examples/react/app/routes/about.ts +10 -0
- package/examples/react/app/routes/health.ts +7 -0
- package/examples/react/app/routes/index.ts +12 -0
- package/examples/react/configs/Dockerfile +26 -0
- package/examples/react/configs/Dockerfile.dockerignore +9 -0
- package/examples/react/configs/env.ts +6 -0
- package/examples/react/configs/infra.ts +55 -0
- package/examples/react/configs/tsconfig.json +16 -0
- package/examples/react/configs/vite.ts +7 -0
- package/examples/react/configs/vitest.ts +9 -0
- package/examples/react/lib/ui/base.css +12 -0
- package/examples/react/lib/ui/layout.ts +18 -0
- package/examples/react/modules/about/views.ts +8 -0
- package/examples/react/modules/shop/products.ts +18 -0
- package/examples/react/modules/shop/shop.css +13 -0
- package/examples/react/modules/shop/shop.test.ts +28 -0
- package/examples/react/modules/shop/shop.ts +13 -0
- package/examples/react/modules/shop/ui/Cart.island.tsx +31 -0
- package/examples/react/modules/shop/views.ts +16 -0
- package/examples/react/package.json +38 -0
- package/examples/react/tsconfig.json +4 -0
- package/examples/services-bun/README.md +10 -0
- package/examples/services-bun/app/assets/main.ts +4 -0
- package/examples/services-bun/app/assets/style.css +1 -0
- package/examples/services-bun/app/crons/nightly.ts +5 -0
- package/examples/services-bun/app/entry.ts +9 -0
- package/examples/services-bun/app/queues/jobs.ts +5 -0
- package/examples/services-bun/app/routes/index.ts +10 -0
- package/examples/services-bun/app/routes/runtime.ts +5 -0
- package/examples/services-bun/app/routes/send.ts +8 -0
- package/examples/services-bun/app/routes/version.ts +5 -0
- package/examples/services-bun/configs/Dockerfile +10 -0
- package/examples/services-bun/configs/Dockerfile.dockerignore +4 -0
- package/examples/services-bun/configs/infra.ts +28 -0
- package/examples/services-bun/configs/tsconfig.json +15 -0
- package/examples/services-bun/configs/vite.ts +4 -0
- package/examples/services-bun/lib/ui/base.css +3 -0
- package/examples/services-bun/lib/ui/layout.ts +13 -0
- package/examples/services-bun/modules/status/client/ready.ts +4 -0
- package/examples/services-bun/modules/status/status.ts +20 -0
- package/examples/services-bun/modules/status/views.ts +4 -0
- package/examples/services-bun/package.json +30 -0
- package/examples/services-bun/public/robots.txt +1 -0
- package/examples/services-bun/tsconfig.json +4 -0
- package/examples/services-cloudflare/README.md +9 -0
- package/examples/services-cloudflare/app/assets/main.ts +4 -0
- package/examples/services-cloudflare/app/crons/nightly.ts +5 -0
- package/examples/services-cloudflare/app/db/main/config.json +4 -0
- package/examples/services-cloudflare/app/db/main/migrations/0001_notes.sql +2 -0
- package/examples/services-cloudflare/app/db/main/queries/add-note.sql +1 -0
- package/examples/services-cloudflare/app/db/main/queries/count-notes.sql +3 -0
- package/examples/services-cloudflare/app/entry.ts +10 -0
- package/examples/services-cloudflare/app/queues/jobs.ts +5 -0
- package/examples/services-cloudflare/app/routes/files.ts +5 -0
- package/examples/services-cloudflare/app/routes/index.ts +10 -0
- package/examples/services-cloudflare/app/routes/limited.ts +7 -0
- package/examples/services-cloudflare/app/routes/send.ts +8 -0
- package/examples/services-cloudflare/configs/env.ts +3 -0
- package/examples/services-cloudflare/configs/infra.ts +85 -0
- package/examples/services-cloudflare/configs/tsconfig.json +15 -0
- package/examples/services-cloudflare/configs/vite.ts +4 -0
- package/examples/services-cloudflare/lib/ui/layout.ts +12 -0
- package/examples/services-cloudflare/modules/files/files.ts +9 -0
- package/examples/services-cloudflare/modules/status/client/ready.ts +4 -0
- package/examples/services-cloudflare/modules/status/status.ts +27 -0
- package/examples/services-cloudflare/modules/status/views.ts +8 -0
- package/examples/services-cloudflare/package.json +30 -0
- package/examples/services-cloudflare/public/robots.txt +1 -0
- package/examples/services-cloudflare/tsconfig.json +4 -0
- package/examples/solid/.env.example +2 -0
- package/examples/solid/README.md +18 -0
- package/examples/solid/app/assets/site.css +3 -0
- package/examples/solid/app/entry.ts +28 -0
- package/examples/solid/app/routes/_middleware.ts +4 -0
- package/examples/solid/app/routes/about.ts +10 -0
- package/examples/solid/app/routes/health.ts +7 -0
- package/examples/solid/app/routes/index.ts +12 -0
- package/examples/solid/configs/Dockerfile +26 -0
- package/examples/solid/configs/Dockerfile.dockerignore +9 -0
- package/examples/solid/configs/env.ts +6 -0
- package/examples/solid/configs/infra.ts +55 -0
- package/examples/solid/configs/tsconfig.json +17 -0
- package/examples/solid/configs/vite.ts +7 -0
- package/examples/solid/configs/vitest.ts +12 -0
- package/examples/solid/lib/ui/base.css +12 -0
- package/examples/solid/lib/ui/layout.ts +18 -0
- package/examples/solid/modules/about/views.ts +8 -0
- package/examples/solid/modules/shop/products.ts +18 -0
- package/examples/solid/modules/shop/shop.css +13 -0
- package/examples/solid/modules/shop/shop.test.ts +28 -0
- package/examples/solid/modules/shop/shop.ts +13 -0
- package/examples/solid/modules/shop/ui/Cart.island.tsx +31 -0
- package/examples/solid/modules/shop/views.ts +16 -0
- package/examples/solid/package.json +35 -0
- package/examples/solid/tsconfig.json +4 -0
- package/examples/starter-bun/.env.example +2 -0
- package/examples/starter-bun/AGENTS.md +9 -0
- package/examples/starter-bun/README.md +47 -0
- package/examples/starter-bun/app/assets/site.css +3 -0
- package/examples/starter-bun/app/db/main/config.json +5 -0
- package/examples/starter-bun/app/db/main/migrations/0001_todos.sql +9 -0
- package/examples/starter-bun/app/db/main/queries/add-todo.sql +2 -0
- package/examples/starter-bun/app/db/main/queries/list-todos.sql +2 -0
- package/examples/starter-bun/app/db/main/queries/toggle-todo.sql +2 -0
- package/examples/starter-bun/app/entry.ts +28 -0
- package/examples/starter-bun/app/routes/_middleware.ts +4 -0
- package/examples/starter-bun/app/routes/health.ts +7 -0
- package/examples/starter-bun/app/routes/index.ts +44 -0
- package/examples/starter-bun/configs/Dockerfile +26 -0
- package/examples/starter-bun/configs/Dockerfile.dockerignore +9 -0
- package/examples/starter-bun/configs/env.ts +6 -0
- package/examples/starter-bun/configs/infra.ts +55 -0
- package/examples/starter-bun/configs/tsconfig.json +15 -0
- package/examples/starter-bun/configs/vite.ts +4 -0
- package/examples/starter-bun/configs/vitest.ts +9 -0
- package/examples/starter-bun/docs/index.md +5 -0
- package/examples/starter-bun/lib/ui/base.css +17 -0
- package/examples/starter-bun/lib/ui/layout.ts +22 -0
- package/examples/starter-bun/modules/todos/todos.css +16 -0
- package/examples/starter-bun/modules/todos/todos.test.ts +33 -0
- package/examples/starter-bun/modules/todos/todos.ts +31 -0
- package/examples/starter-bun/modules/todos/views.ts +38 -0
- package/examples/starter-bun/package.json +32 -0
- package/examples/starter-bun/public/favicon.svg +1 -0
- package/examples/starter-bun/tsconfig.json +4 -0
- package/examples/starter-cloudflare/.env.example +2 -0
- package/examples/starter-cloudflare/AGENTS.md +9 -0
- package/examples/starter-cloudflare/README.md +47 -0
- package/examples/starter-cloudflare/app/assets/site.css +3 -0
- package/examples/starter-cloudflare/app/db/main/config.json +5 -0
- package/examples/starter-cloudflare/app/db/main/migrations/0001_todos.sql +9 -0
- package/examples/starter-cloudflare/app/db/main/queries/add-todo.sql +2 -0
- package/examples/starter-cloudflare/app/db/main/queries/list-todos.sql +2 -0
- package/examples/starter-cloudflare/app/db/main/queries/toggle-todo.sql +2 -0
- package/examples/starter-cloudflare/app/entry.ts +28 -0
- package/examples/starter-cloudflare/app/routes/_middleware.ts +4 -0
- package/examples/starter-cloudflare/app/routes/health.ts +7 -0
- package/examples/starter-cloudflare/app/routes/index.ts +44 -0
- package/examples/starter-cloudflare/configs/env.ts +6 -0
- package/examples/starter-cloudflare/configs/infra.ts +85 -0
- package/examples/starter-cloudflare/configs/tsconfig.json +15 -0
- package/examples/starter-cloudflare/configs/vite.ts +4 -0
- package/examples/starter-cloudflare/configs/vitest.ts +9 -0
- package/examples/starter-cloudflare/docs/index.md +5 -0
- package/examples/starter-cloudflare/lib/ui/base.css +17 -0
- package/examples/starter-cloudflare/lib/ui/layout.ts +22 -0
- package/examples/starter-cloudflare/modules/todos/todos.css +16 -0
- package/examples/starter-cloudflare/modules/todos/todos.test.ts +33 -0
- package/examples/starter-cloudflare/modules/todos/todos.ts +31 -0
- package/examples/starter-cloudflare/modules/todos/views.ts +38 -0
- package/examples/starter-cloudflare/package.json +32 -0
- package/examples/starter-cloudflare/public/favicon.svg +1 -0
- package/examples/starter-cloudflare/tsconfig.json +4 -0
- package/examples/svelte/.env.example +2 -0
- package/examples/svelte/README.md +18 -0
- package/examples/svelte/app/assets/site.css +3 -0
- package/examples/svelte/app/entry.ts +28 -0
- package/examples/svelte/app/routes/_middleware.ts +4 -0
- package/examples/svelte/app/routes/about.ts +10 -0
- package/examples/svelte/app/routes/health.ts +7 -0
- package/examples/svelte/app/routes/index.ts +12 -0
- package/examples/svelte/configs/env.ts +6 -0
- package/examples/svelte/configs/infra.ts +85 -0
- package/examples/svelte/configs/tsconfig.json +15 -0
- package/examples/svelte/configs/vite.ts +9 -0
- package/examples/svelte/configs/vitest.ts +9 -0
- package/examples/svelte/lib/types/svelte.d.ts +8 -0
- package/examples/svelte/lib/ui/base.css +12 -0
- package/examples/svelte/lib/ui/layout.ts +18 -0
- package/examples/svelte/modules/about/views.ts +8 -0
- package/examples/svelte/modules/shop/products.ts +18 -0
- package/examples/svelte/modules/shop/shop.css +13 -0
- package/examples/svelte/modules/shop/shop.test.ts +28 -0
- package/examples/svelte/modules/shop/shop.ts +13 -0
- package/examples/svelte/modules/shop/ui/Cart.island.svelte +23 -0
- package/examples/svelte/modules/shop/views.ts +16 -0
- package/examples/svelte/package.json +35 -0
- package/examples/svelte/tsconfig.json +4 -0
- package/examples/tailwind/.env.example +2 -0
- package/examples/tailwind/README.md +16 -0
- package/examples/tailwind/app/assets/site.css +2 -0
- package/examples/tailwind/app/entry.ts +28 -0
- package/examples/tailwind/app/routes/_middleware.ts +4 -0
- package/examples/tailwind/app/routes/health.ts +7 -0
- package/examples/tailwind/app/routes/index.ts +30 -0
- package/examples/tailwind/configs/Dockerfile +26 -0
- package/examples/tailwind/configs/Dockerfile.dockerignore +9 -0
- package/examples/tailwind/configs/env.ts +6 -0
- package/examples/tailwind/configs/infra.ts +55 -0
- package/examples/tailwind/configs/tsconfig.json +15 -0
- package/examples/tailwind/configs/vite.ts +7 -0
- package/examples/tailwind/configs/vitest.ts +9 -0
- package/examples/tailwind/lib/ui/components.ts +21 -0
- package/examples/tailwind/lib/ui/layout.ts +21 -0
- package/examples/tailwind/lib/ui/theme.css +10 -0
- package/examples/tailwind/modules/team/team.test.ts +30 -0
- package/examples/tailwind/modules/team/team.ts +34 -0
- package/examples/tailwind/modules/team/views.ts +45 -0
- package/examples/tailwind/package.json +35 -0
- package/examples/tailwind/tsconfig.json +4 -0
- package/examples/vue/.env.example +2 -0
- package/examples/vue/README.md +18 -0
- package/examples/vue/app/assets/site.css +3 -0
- package/examples/vue/app/entry.ts +28 -0
- package/examples/vue/app/routes/_middleware.ts +4 -0
- package/examples/vue/app/routes/about.ts +10 -0
- package/examples/vue/app/routes/health.ts +7 -0
- package/examples/vue/app/routes/index.ts +12 -0
- package/examples/vue/configs/env.ts +6 -0
- package/examples/vue/configs/infra.ts +85 -0
- package/examples/vue/configs/tsconfig.json +15 -0
- package/examples/vue/configs/vite.ts +7 -0
- package/examples/vue/configs/vitest.ts +9 -0
- package/examples/vue/lib/types/vue.d.ts +8 -0
- package/examples/vue/lib/ui/base.css +12 -0
- package/examples/vue/lib/ui/layout.ts +18 -0
- package/examples/vue/modules/about/views.ts +8 -0
- package/examples/vue/modules/shop/products.ts +18 -0
- package/examples/vue/modules/shop/shop.css +13 -0
- package/examples/vue/modules/shop/shop.test.ts +28 -0
- package/examples/vue/modules/shop/shop.ts +13 -0
- package/examples/vue/modules/shop/ui/Cart.island.vue +27 -0
- package/examples/vue/modules/shop/views.ts +16 -0
- package/examples/vue/package.json +35 -0
- package/examples/vue/tsconfig.json +4 -0
- package/package.json +44 -3
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Markdown, HTML, code groups, callouts and diagrams in the docs reader
|
|
3
|
+
icon: pencil
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Writing docs
|
|
7
|
+
|
|
8
|
+
`space docs` shows your app's `docs/` folder next to spacefn's docs, and `space dev` serves the same reader at `/__space/docs/`. Pages are Markdown files; edit one and the open page reloads.
|
|
9
|
+
|
|
10
|
+
## Pages and the sidebar
|
|
11
|
+
|
|
12
|
+
Every `.md` file in `docs/` is a page, and every folder is a group in the sidebar. A folder's `index.md` (or `README.md`) is its first page and names the group. Groups collapse: the one with the open page starts open, and the reader remembers the ones you open or close.
|
|
13
|
+
|
|
14
|
+
Number files and folders to put them in reading order. The number orders the sidebar and is left out everywhere else: `2-runbooks/1-deploys.md` is "Deploys" in "Runbooks", at `/runbooks/deploys.md`.
|
|
15
|
+
|
|
16
|
+
```txt
|
|
17
|
+
docs/
|
|
18
|
+
├── index.md the home page
|
|
19
|
+
├── 1-architecture.md /architecture.md
|
|
20
|
+
└── 2-runbooks/
|
|
21
|
+
├── index.md "Runbooks", the group's title
|
|
22
|
+
├── 1-deploys.md /runbooks/deploys.md
|
|
23
|
+
└── 2-incidents.md /runbooks/incidents.md
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Without numbers, pages are in name order. Frontmatter `order` overrides the number, and `title` the first `# heading`:
|
|
27
|
+
|
|
28
|
+
```md [docs/1-architecture.md]
|
|
29
|
+
---
|
|
30
|
+
title: How it fits together
|
|
31
|
+
order: 2
|
|
32
|
+
description: One line, shown on the folder's cards
|
|
33
|
+
icon: building-bridge
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
# Architecture
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
`icon` puts a [Tabler icon](https://tabler.io/icons) before the page in the sidebar: its name as on the site, such as `rocket`, or `heart-filled` for the filled one. A folder's `index.md` gives the folder its icon. A page without `icon` has none. The icons load from a CDN, like Mermaid, so they're missing offline.
|
|
40
|
+
|
|
41
|
+
Link between pages by their file names, as you would on GitHub: `[deploys](2-runbooks/1-deploys.md)`. The reader sends such a link to the page's URL. Put images next to the pages and link them the same way. Don't give two files in a folder the same name apart from the number, such as `deploys.md` and `1-deploys.md`: only the one without a number is reachable.
|
|
42
|
+
|
|
43
|
+
## Code
|
|
44
|
+
|
|
45
|
+
Fenced code is highlighted by [Shiki](https://shiki.style). Name the file in brackets after the language, and list lines to highlight in braces:
|
|
46
|
+
|
|
47
|
+
````md
|
|
48
|
+
```ts [app/routes/health.ts] {3}
|
|
49
|
+
import { Effect } from "effect";
|
|
50
|
+
|
|
51
|
+
export const GET = () => Effect.succeed(Response.json({ ok: true }));
|
|
52
|
+
```
|
|
53
|
+
````
|
|
54
|
+
|
|
55
|
+
```ts [app/routes/health.ts] {3}
|
|
56
|
+
import { Effect } from "effect";
|
|
57
|
+
|
|
58
|
+
export const GET = () => Effect.succeed(Response.json({ ok: true }));
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Comments mark lines too, and the comment is left out of the page: `// [!code ++]` and `// [!code --]` for a diff, `// [!code highlight]`, `// [!code focus]`, and `// [!code error]` or `// [!code warning]`.
|
|
62
|
+
|
|
63
|
+
```ts
|
|
64
|
+
const limit = 10; // [!code --]
|
|
65
|
+
const limit = 50; // [!code ++]
|
|
66
|
+
const page = yield * Pages.list({ limit }); // [!code focus]
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Code groups
|
|
70
|
+
|
|
71
|
+
Wrap blocks in `<code-group>` to show them as tabs. Each tab is named by the block's `[title]`. Choosing a tab chooses it in every group on the page that has one with that name, and the reader remembers it:
|
|
72
|
+
|
|
73
|
+
````md
|
|
74
|
+
<code-group>
|
|
75
|
+
|
|
76
|
+
```sh [npm]
|
|
77
|
+
npm create spacefn@latest my-app
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```sh [pnpm]
|
|
81
|
+
pnpm create spacefn my-app
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
</code-group>
|
|
85
|
+
````
|
|
86
|
+
|
|
87
|
+
<code-group>
|
|
88
|
+
|
|
89
|
+
```sh [npm]
|
|
90
|
+
npm create spacefn@latest my-app
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
```sh [pnpm]
|
|
94
|
+
pnpm create spacefn my-app
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
```sh [bun]
|
|
98
|
+
bun create spacefn my-app
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
</code-group>
|
|
102
|
+
|
|
103
|
+
Leave a blank line after `<code-group>` and before `</code-group>`, so the blocks inside are read as Markdown.
|
|
104
|
+
|
|
105
|
+
## Callouts
|
|
106
|
+
|
|
107
|
+
GitHub's alerts become callouts. Text after the kind names it:
|
|
108
|
+
|
|
109
|
+
```md
|
|
110
|
+
> [!TIP] Run it in CI
|
|
111
|
+
> `space db status` exits non-zero when a migration is pending.
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
> [!NOTE]
|
|
115
|
+
> Notes add something worth knowing.
|
|
116
|
+
|
|
117
|
+
> [!TIP] Run it in CI
|
|
118
|
+
> `space db status` exits non-zero when a migration is pending.
|
|
119
|
+
|
|
120
|
+
> [!IMPORTANT]
|
|
121
|
+
> Important is what readers must not miss.
|
|
122
|
+
|
|
123
|
+
> [!WARNING]
|
|
124
|
+
> Warnings are about something that can go wrong.
|
|
125
|
+
|
|
126
|
+
> [!CAUTION]
|
|
127
|
+
> Caution is about something that can't be undone.
|
|
128
|
+
|
|
129
|
+
## Diagrams
|
|
130
|
+
|
|
131
|
+
A `mermaid` block draws a [Mermaid](https://mermaid.js.org) diagram, in the page's light or dark theme and the code font. The browser loads Mermaid when a page has one; offline, the diagram's source shows instead.
|
|
132
|
+
|
|
133
|
+
````md
|
|
134
|
+
```mermaid
|
|
135
|
+
sequenceDiagram
|
|
136
|
+
Browser->>Worker: POST /todos
|
|
137
|
+
Worker->>D1: insert
|
|
138
|
+
Worker-->>Browser: 303 to /todos
|
|
139
|
+
```
|
|
140
|
+
````
|
|
141
|
+
|
|
142
|
+
```mermaid
|
|
143
|
+
sequenceDiagram
|
|
144
|
+
Browser->>Worker: POST /todos
|
|
145
|
+
Worker->>D1: insert
|
|
146
|
+
Worker-->>Browser: 303 to /todos
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## HTML
|
|
150
|
+
|
|
151
|
+
HTML in a page is kept as written, so a page can have anything Markdown lacks. Markdown inside an HTML block works when a blank line follows the opening tag:
|
|
152
|
+
|
|
153
|
+
```html
|
|
154
|
+
<details>
|
|
155
|
+
<summary>What's in .space/?</summary>
|
|
156
|
+
|
|
157
|
+
Generated code: the route table, typed queries, and the Worker or server entry.
|
|
158
|
+
</details>
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
<details>
|
|
162
|
+
<summary>What's in .space/?</summary>
|
|
163
|
+
|
|
164
|
+
Generated code: the route table, typed queries, and the Worker or server entry.
|
|
165
|
+
|
|
166
|
+
</details>
|
|
167
|
+
|
|
168
|
+
A few classes are styled for you:
|
|
169
|
+
|
|
170
|
+
| Markup | Shows |
|
|
171
|
+
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
172
|
+
| `<span class="badge tip">new</span>` | A badge: <span class="badge">note</span> <span class="badge tip">tip</span> <span class="badge warning">warning</span> <span class="badge caution">caution</span> |
|
|
173
|
+
| `<div class="callout tip">` | A callout, like `> [!TIP]`, for content an alert can't hold |
|
|
174
|
+
| `<div class="steps">` around `###` headings | Numbered steps |
|
|
175
|
+
| `<div class="cards">` around a list of links | A grid of cards |
|
|
176
|
+
| `<kbd>⌘</kbd> <kbd>K</kbd>` | Keys: <kbd>⌘</kbd> <kbd>K</kbd> |
|
|
177
|
+
|
|
178
|
+
<div class="steps">
|
|
179
|
+
|
|
180
|
+
### Write the migration
|
|
181
|
+
|
|
182
|
+
Add `app/db/main/migrations/0002_add_done.sql`.
|
|
183
|
+
|
|
184
|
+
### Write the query
|
|
185
|
+
|
|
186
|
+
Add `app/db/main/queries/todos/mark-done.sql`; `space gen` types it.
|
|
187
|
+
|
|
188
|
+
### Call it
|
|
189
|
+
|
|
190
|
+
`yield* MainDb.todos.markDone({ id })` in a route or a page action.
|
|
191
|
+
|
|
192
|
+
</div>
|
|
193
|
+
|
|
194
|
+
<div class="cards">
|
|
195
|
+
|
|
196
|
+
- [Database](../6-guides/5-database.md)<br>Migrations and typed queries
|
|
197
|
+
- [Pages](../6-guides/3-pages.md)<br>Server-rendered pages and forms
|
|
198
|
+
- [Testing](../6-guides/9-testing.md)<br>Pages, routes and queries in memory
|
|
199
|
+
|
|
200
|
+
</div>
|
|
201
|
+
|
|
202
|
+
A page can also have a `<style>` or a `<script>` of its own, for a small live example.
|
|
203
|
+
|
|
204
|
+
## Searching
|
|
205
|
+
|
|
206
|
+
<kbd>⌘</kbd> <kbd>K</kbd> or <kbd>/</kbd> searches both doc sets: page titles, headings, and the text under each heading.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
icon: books
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Reference
|
|
6
|
+
|
|
7
|
+
The settings, commands and file formats, to look up.
|
|
8
|
+
|
|
9
|
+
| Page | What it covers |
|
|
10
|
+
| --------------------------------- | --------------------------------------------------------------------- |
|
|
11
|
+
| [Configuration](1-config.md) | `configs/vite.ts`, `configs/env.ts`, `.env` files, `configs/infra.ts` |
|
|
12
|
+
| [CLI](2-cli.md) | Every `space` command, and its errors |
|
|
13
|
+
| [Writing docs](3-writing-docs.md) | Your app's own `docs/`, in the same reader |
|
|
14
|
+
|
|
15
|
+
For what each folder of an app holds, see [Folders](../4-folders/index.md).
|
package/content/index.md
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
icon: home
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Introduction
|
|
6
|
+
|
|
7
|
+
spacefn builds full-stack TypeScript apps from folders of convention files, on [Effect](https://effect.website). The same app runs on **Cloudflare Workers** or on **Bun** (in Docker). You write routes, pages, SQL and jobs; spacefn generates the wiring into `.space/`, and the `space` CLI runs, builds and deploys it.
|
|
8
|
+
|
|
9
|
+
Start with [Getting started](1-getting-started.md) and [Conventions](2-conventions.md), then read what you need. [Best practices](3-best-practices.md) says how to keep an app easy to change as it grows.
|
|
10
|
+
|
|
11
|
+
**Folders.** A page for each folder and file of an app, to browse like a map: [`app/`](4-folders/1-app/index.md) and its [`entry.ts`](4-folders/1-app/1-entry.md), [`routes/`](4-folders/1-app/2-routes.md), [`db/`](4-folders/1-app/3-db.md), [`queues/`](4-folders/1-app/4-queues.md), [`crons/`](4-folders/1-app/5-crons.md), [`assets/`](4-folders/1-app/6-assets.md), [`durable-objects/`](4-folders/1-app/7-durable-objects.md) and [`workflows/`](4-folders/1-app/8-workflows.md); then [`modules/`](4-folders/2-modules.md), [`lib/`](4-folders/3-lib.md), [`public/`](4-folders/4-public.md), [`docs/`](4-folders/5-docs.md), [`configs/`](4-folders/6-configs.md), [`.space/`](4-folders/7-space.md), [`.env`](4-folders/8-env.md) and [`package.json`](4-folders/9-package-json.md). [See them all](4-folders/index.md).
|
|
12
|
+
|
|
13
|
+
**Deployment**
|
|
14
|
+
|
|
15
|
+
| Page | What it covers |
|
|
16
|
+
| -------------------------------------------------- | ------------------------------------------------------------ |
|
|
17
|
+
| [Deployment](5-deployment/index.md) | `space deploy`, stages, telemetry |
|
|
18
|
+
| [Cloudflare](5-deployment/1-cloudflare.md) | What a deploy creates, domains, local dev |
|
|
19
|
+
| [Bun](5-deployment/2-bun.md) | The processes, the image, servers, more than one machine |
|
|
20
|
+
| [Infrastructure](5-deployment/3-infrastructure.md) | `configs/infra.ts`, `#space/infra.ts`, `variables`, state |
|
|
21
|
+
| [CI/CD](5-deployment/4-ci-cd.md) | Cloudflare tokens, GitHub Actions, GitLab CI, preview stages |
|
|
22
|
+
|
|
23
|
+
**Guides**
|
|
24
|
+
|
|
25
|
+
| Page | What it covers |
|
|
26
|
+
| --------------------------------------------- | --------------------------------------------------------------------- |
|
|
27
|
+
| [The entry](6-guides/1-entry.md) | `app/entry.ts`: services, middleware, extra routes, `onError` |
|
|
28
|
+
| [Routes and middleware](6-guides/2-routes.md) | HTTP endpoints, reading input, errors, middleware, CSRF |
|
|
29
|
+
| [Pages](6-guides/3-pages.md) | Server-rendered pages, form actions, live updates with Datastar |
|
|
30
|
+
| [Frontend](6-guides/4-frontend.md) | Asset entries, `public/`, CSS, framework islands, Datastar components |
|
|
31
|
+
| [Database](6-guides/5-database.md) | Migrations, typed SQL queries, drivers, a database per tenant |
|
|
32
|
+
| [Services](6-guides/6-services.md) | Kv, Blob, Queue, Bus and RateLimiter, and what backs them per target |
|
|
33
|
+
| [Queues and crons](6-guides/7-jobs.md) | Background jobs and scheduled jobs |
|
|
34
|
+
| [Auth](6-guides/8-auth.md) | Passwords, sessions, rate limiting, TOTP, signed tokens, OAuth |
|
|
35
|
+
| [Testing](6-guides/9-testing.md) | Testing modules, pages and routes in memory |
|
|
36
|
+
|
|
37
|
+
**Reference**
|
|
38
|
+
|
|
39
|
+
| Page | What it covers |
|
|
40
|
+
| --------------------------------------------- | --------------------------------------------------------------------- |
|
|
41
|
+
| [Configuration](7-reference/1-config.md) | `configs/vite.ts`, `configs/env.ts`, `.env` files, `configs/infra.ts` |
|
|
42
|
+
| [CLI](7-reference/2-cli.md) | Every `space` command |
|
|
43
|
+
| [Writing docs](7-reference/3-writing-docs.md) | Your app's own `docs/`, in the same reader |
|
|
44
|
+
|
|
45
|
+
**Examples.** Every convention here is shown in full by an app in the repo's `examples/`, tested and shipped with these docs in `node_modules/spacefn-docs/examples/`: the starters, Datastar with Rocket, Tailwind, Lightning CSS, React, Vue, Solid and Svelte islands, and a database per shop.
|
|
46
|
+
|
|
47
|
+
You need to know a little Effect: handlers are `Effect`s, and you get a service with `yield*` inside `Effect.gen`. Effect's own docs cover the rest.
|
|
48
|
+
|
|
49
|
+
The VS Code extension (`wai-lin.vscode-spacefn`) checks SQL against your migrations, in query files and in `` sql`...` `` templates, validates Datastar attributes in `` html`...` ``, and checks and completes the CSS in their `<style>` tags.
|
package/content/logo.svg
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
|
2
|
+
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
|
3
|
+
<svg width="100%" height="100%" viewBox="0 0 595 353" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
|
|
4
|
+
<g transform="matrix(1,0,0,1,-32.119507,-90.998334)">
|
|
5
|
+
<g transform="matrix(1,-0,-0,1,32.119507,90.998334)">
|
|
6
|
+
<use xlink:href="#_Image1" x="0" y="0" width="595px" height="353px"/>
|
|
7
|
+
</g>
|
|
8
|
+
</g>
|
|
9
|
+
<defs>
|
|
10
|
+
<image id="_Image1" width="595px" height="353px" xlink:href="data:image/png;base64,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"/>
|
|
11
|
+
</defs>
|
|
12
|
+
</svg>
|
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { IncomingMessage, ServerResponse } from "node:http";
|
|
2
|
+
/** A docs folder the reader serves. */
|
|
3
|
+
interface DocsSource {
|
|
4
|
+
/** Its name in the top bar, e.g. the app's name or `spacefn`. */
|
|
5
|
+
readonly label: string;
|
|
6
|
+
readonly dir: string;
|
|
7
|
+
/** Its path under the reader's base: `""` for one source, else e.g. `spacefn/`. */
|
|
8
|
+
readonly prefix: string;
|
|
9
|
+
readonly version?: string;
|
|
10
|
+
}
|
|
11
|
+
interface ReaderOptions {
|
|
12
|
+
/** The URL the reader is served at, e.g. `/` or `/__space/docs/`. */
|
|
13
|
+
readonly base: string;
|
|
14
|
+
readonly sources: readonly DocsSource[];
|
|
15
|
+
/** The site's name in the top bar. */
|
|
16
|
+
readonly name: string;
|
|
17
|
+
}
|
|
18
|
+
interface Reader {
|
|
19
|
+
/** A Node or Connect handler; `next` is called for URLs outside the base. */
|
|
20
|
+
readonly handle: (req: IncomingMessage, res: ServerResponse, next?: () => void) => Promise<void>;
|
|
21
|
+
/** Stops watching the docs folders. */
|
|
22
|
+
readonly close: () => void;
|
|
23
|
+
}
|
|
24
|
+
export declare const createReader: (options: ReaderOptions) => Reader;
|
|
25
|
+
interface TocEntry {
|
|
26
|
+
readonly depth: 2 | 3;
|
|
27
|
+
readonly text: string;
|
|
28
|
+
readonly id: string;
|
|
29
|
+
}
|
|
30
|
+
/** A page's text under each heading, for search. */
|
|
31
|
+
interface Section {
|
|
32
|
+
readonly id: string | null;
|
|
33
|
+
readonly heading: string | null;
|
|
34
|
+
readonly text: string;
|
|
35
|
+
}
|
|
36
|
+
interface Rendered {
|
|
37
|
+
readonly html: string;
|
|
38
|
+
/** The first `# heading`, if the page has one. */
|
|
39
|
+
readonly title: string | null;
|
|
40
|
+
readonly toc: readonly TocEntry[];
|
|
41
|
+
readonly sections: readonly Section[];
|
|
42
|
+
/** Whether the page has a `mermaid` block, so the page loads Mermaid. */
|
|
43
|
+
readonly mermaid: boolean;
|
|
44
|
+
readonly frontmatter: Frontmatter;
|
|
45
|
+
}
|
|
46
|
+
/** The `key: value` lines between `---` fences at the top of a page. */
|
|
47
|
+
type Frontmatter = Readonly<Record<string, string>>;
|
|
48
|
+
export declare const renderMarkdown: (source: string) => Promise<Rendered>;
|
|
49
|
+
/** spacefn's own docs, as installed. */
|
|
50
|
+
export declare const contentDir: string;
|
|
51
|
+
/** The installed version, which matches the spacefn it documents. */
|
|
52
|
+
export declare const version: string;
|
|
53
|
+
/** spacefn's docs. */
|
|
54
|
+
export declare const spacefnSource: (prefix: string) => DocsSource;
|
|
55
|
+
export interface AppDocsOptions {
|
|
56
|
+
/** The app root: its `docs/` folder is served first, spacefn's docs under `spacefn/`. */
|
|
57
|
+
readonly root: string;
|
|
58
|
+
/** Where the reader is served, e.g. `/` or `/__space/docs/`. */
|
|
59
|
+
readonly base: string;
|
|
60
|
+
}
|
|
61
|
+
/** The reader for an app: its own `docs/` (if any) and spacefn's docs. */
|
|
62
|
+
export declare const appDocs: ({ root, base }: AppDocsOptions) => Reader;
|
|
63
|
+
export interface ServeOptions extends Omit<AppDocsOptions, "base"> {
|
|
64
|
+
readonly port?: number;
|
|
65
|
+
readonly host?: string;
|
|
66
|
+
}
|
|
67
|
+
/** `space docs`: the app's reader on its own server. */
|
|
68
|
+
export declare const serve: ({ root, port, host }: ServeOptions) => Promise<{
|
|
69
|
+
url: string;
|
|
70
|
+
close: () => Promise<void>;
|
|
71
|
+
}>;
|
|
72
|
+
export type { DocsSource, Reader, ReaderOptions, Rendered, TocEntry };
|