spacefn-docs 0.0.0-stage → 0.11.1
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 +35 -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 +70 -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 +179 -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 +45 -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 +88 -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 +88 -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 +88 -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 +35 -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 +88 -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 +88 -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,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
icon: terminal-2
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# CLI
|
|
6
|
+
|
|
7
|
+
`space` comes with `spacefn`. Run it with `npx space <command>`, or through the app's scripts (`npm run dev`).
|
|
8
|
+
|
|
9
|
+
| Command | What it does |
|
|
10
|
+
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
11
|
+
| `space dev [--port N]` | Runs the app locally and regenerates `.space/` on every change. Cloudflare: workerd through Alchemy. Bun: Vite inside Bun, with queues and crons in the same process. |
|
|
12
|
+
| `space build` | `vite build` with `configs/vite.ts`, into `dist/` (Bun). Cloudflare builds during `deploy`. |
|
|
13
|
+
| `space deploy [--stage S] [--yes]` | `alchemy deploy configs/infra.ts` for stage `S` (default `prod`). `--yes` skips the approval. |
|
|
14
|
+
| `space destroy [--stage S] [--yes]` | `alchemy destroy configs/infra.ts`: deletes everything stage `S` deployed, its data included. |
|
|
15
|
+
| `space gen [--watch] [--prod]` | Writes `.space/` from `app/` and `configs/`. `--prod` takes `.prod.ts` files instead of `.dev.ts`. |
|
|
16
|
+
| `space db status\|migrate\|rollback [--db name] [--steps N]` | Migrations of libSQL databases. See [Database](../6-guides/5-database.md). |
|
|
17
|
+
| `space doctor` | Checks Node, the config, `.space/`, the target's tools, the bindings in `configs/infra.ts` and `configs/env.ts`, and says what to fix. |
|
|
18
|
+
| `space upgrade` | Updates spacefn and what moves with it, then regenerates. See [Upgrading](#upgrading). |
|
|
19
|
+
| `space docs [--port N]` | Serves your `docs/` and spacefn's docs at `http://localhost:4321/`. `space dev` serves them too, at `/__space/docs/`. See [Writing docs](3-writing-docs.md). |
|
|
20
|
+
| `space clean` | Deletes generated files and builds. Keeps local data. |
|
|
21
|
+
|
|
22
|
+
## Upgrading
|
|
23
|
+
|
|
24
|
+
`space upgrade` reads the latest release from the registry, prints each change as `old → new`, and installs them at once with the app's package manager:
|
|
25
|
+
|
|
26
|
+
| Package | Moves to |
|
|
27
|
+
| --------------------------- | ---------------------------------------------- |
|
|
28
|
+
| `spacefn`, `spacefn-docs` | the latest release |
|
|
29
|
+
| `alchemy` and its providers | the exact version that release is built on |
|
|
30
|
+
| `effect`, `vite` | what that release needs, if the app's is older |
|
|
31
|
+
| everything else | stays: the app's choice |
|
|
32
|
+
|
|
33
|
+
An exact version stays exact. If the install fails or you stop it, `package.json` and the lockfile are put back and installed again. A version it can't edit, such as `catalog:` or `workspace:`, stops it before anything changes. It needs `npm` to read the registry, whichever package manager the app uses.
|
|
34
|
+
|
|
35
|
+
> [!IMPORTANT]
|
|
36
|
+
> In spacefn 0.11.0, `space upgrade` updates only spacefn. From that version, upgrade with the latest one's instead: `npx spacefn@latest upgrade`.
|
|
37
|
+
|
|
38
|
+
## Errors
|
|
39
|
+
|
|
40
|
+
Every command prints errors with a code, the file and a hint, for example:
|
|
41
|
+
|
|
42
|
+
```txt
|
|
43
|
+
[CRON_SCHEDULE_LITERAL] app/crons/nightly.ts: The schedule must be a string literal
|
|
44
|
+
hint: Write it in the file: export default cron("0 3 * * *", job). The infra reads it without running the file.
|
|
45
|
+
```
|
|
@@ -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 and dashboard, 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 };
|