@puckeditor/cli 0.24.0-canary.301a0304

package/dist/docs/integrating-puck/viewports.md

@@ -0,0 +1,75 @@
+# Viewports
+
+The Puck preview renders in a same-origin iframe that can be resized to simulate different viewports.
+
+## Default viewports
+
+Puck provides 4 viewports [by default](/docs/api-reference/components/puck#default-viewports):
+
+1. Small: 360px wide
+2. Medium: 768px wide
+3. Large: 1280px wide
+4. Full-width: Fit the container
+
+Each of the default viewports have 100% height, filling the available space (via the `auto` height parameter).
+
+## Customizing viewports
+
+Customizing the available viewports using the [`viewports` API](/docs/api-reference/components/puck#viewports):
+
+```tsx
+export function Editor() {
+  return (
+    <Puck
+      viewports={[
+        {
+          width: 1440,
+          height: "auto", // Optional height. Can be numeric or "auto". Defaults to "auto".
+          label: "My Viewport", // Optional. Shown in tooltip.
+          icon: <svg />, // Optional. Use lucide-icons to align with Puck UI.
+        },
+      ]}
+      // ...
+    />
+  );
+}
+```
+
+## Disable viewports
+
+Disable viewport behavior by disabling iframes with [`iframe.enabled`](/docs/api-reference/components/puck#enabled):
+
+```tsx
+export function Editor() {
+  return (
+    <Puck
+      iframe={{
+        enabled: false,
+      }}
+      // ...
+    />
+  );
+}
+```
+
+Note that this will also disable [style isolation](/docs/integrating-puck/styling#style-isolation).
+
+## Controlling viewports with compositional interfaces
+
+When implementing a [compositional interface](/docs/extending-puck/composition), the `viewports` API will have no effect. Instead, the viewport size can be controlled by the dimensions of the wrapping element that contains [`<Puck.Preview />`](/docs/api-reference/components/puck-preview).
+
+CSS transforms can be used to zoom the viewport without impacting drag-and-drop behaviour.
+
+```tsx
+import { Puck } from "@puckeditor/core";
+
+export function Editor() {
+  return (
+    <Puck>
+      <div style={{ transform: "scale(0.5)", width: 1280 }}>
+        <Puck.Preview />
+      </div>
+    </Puck>
+  );
+}
+```

package/dist/templates/astro/README.md

@@ -0,0 +1,52 @@
+# Puck + Astro recipe
+
+[Puck](https://puckeditor.com) is the open-source visual editor for React.
+
+This recipe adds Puck to an [Astro](https://astro.build) site. The editor runs as a React island, published pages are rendered on the server, and the [Node adapter](https://docs.astro.build/en/guides/integrations-guide/node/) serves Puck's API routes on demand while the rest of the site can stay static.
+
+## Run the recipe
+
+### 1. Start the development server
+
+Run:
+
+```sh
+npm run dev
+```
+
+Once the server is running, navigate to [http://localhost:4321](http://localhost:4321) to view the home page, or [http://localhost:4321/edit](http://localhost:4321/edit) to edit it with Puck.
+
+### 2. Publish a page
+
+Open the `Blocks` tab in the left sidebar and drag components onto the canvas. Once your page is ready, select **Publish** in the header to save it, then navigate to [http://localhost:4321](http://localhost:4321) to view it.
+
+You can also create a page at any path by navigating to `/your/path/edit` and publishing it.
+
+## How it works
+
+`src/pages/[...puckPath].astro` handles every URL without its own page. When a URL ends in `/edit`, it renders the editor for that path as a client-only React island. Otherwise it loads the published page and renders it with [`<Render>`](https://puckeditor.com/docs/api-reference/components/render) on the server, so no editor code is sent to visitors.
+
+| File                            | Purpose                                                                                            |
+| ------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `src/puck.config.tsx`           | Defines the components, fields, and default props available to Puck. Add your own components here. |
+| `src/pages/[...puckPath].astro` | Renders the editor at `/edit` URLs, and published pages everywhere else.                           |
+| `src/pages/api/pages.ts`        | Loads and saves pages for the editor.                                                              |
+| `src/puck/editor.tsx`           | Loads the page being edited and publishes changes.                                                 |
+| `src/puck/render.tsx`           | Renders a published page.                                                                          |
+| `src/lib/pages.ts`              | Reads and writes page data in `database.json`. Replace this with your own database.                |
+| `database.json`                 | Acts as a local database. Replace this with your own database solution.                            |
+
+## Before deploying to production
+
+Before deploying this recipe, make sure to:
+
+- **Protect the editor and APIs.** The `/edit` routes and `/api/pages` route are public by default. Add authentication and authorization.
+- **Add your component library.** Replace the example `HeadingBlock` in `src/puck.config.tsx` with the components and fields your users need.
+- **Use a real database.** Replace `database.json` and `src/lib/pages.ts`. Local files are not reliable across server instances or serverless deployments.
+
+## Learn more
+
+- [Puck documentation](https://puckeditor.com/docs)
+- [Integrating Puck](https://puckeditor.com/docs/integrating-puck/component-configuration)
+- [Astro](https://docs.astro.build)
+- [Puck Discord](https://discord.gg/D9e4E3MQVZ)

package/dist/templates/astro/_gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/

package/dist/templates/astro/astro.config.mjs

@@ -0,0 +1,14 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+
+import react from "@astrojs/react";
+import node from "@astrojs/node";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [react()],
+
+  adapter: node({
+    mode: "standalone",
+  }),
+});

package/dist/templates/astro/database.json

@@ -0,0 +1 @@
+{"/":{"content":[{"type":"HeadingBlock","props":{"title":"Edit this page by adding /edit to the end of the URL","id":"HeadingBlock-1694032984497"}}],"root":{"props": {"title":""}}}}

package/dist/templates/astro/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "astro-recipe",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "start": "node dist/server/entry.mjs",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/node": "^11.1.6",
+    "@astrojs/react": "^7.0.0",
+    "@puckeditor/core": "workspace:*",
+    "astro": "^7.3.5",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0"
+  }
+}

package/dist/templates/astro/public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

package/dist/templates/astro/src/lib/pages.ts

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+import type { Data } from "@puckeditor/core";
+
+// Replace this with your own database
+const databasePath = "database.json";
+
+const readPages = async (): Promise<Record<string, Data>> => {
+  try {
+    return JSON.parse(await fs.readFile(databasePath, "utf-8"));
+  } catch {
+    return {};
+  }
+};
+
+export const getPage = async (path: string) => (await readPages())[path];
+
+export const savePage = async (path: string, data: Data) => {
+  const pages = await readPages();
+  pages[path] = data;
+  await fs.writeFile(databasePath, JSON.stringify(pages));
+};

package/dist/templates/astro/src/lib/resolve-puck-path.ts

@@ -0,0 +1,19 @@
+export function resolvePuckPath(
+  path = "",
+  // `base` can be any valid origin, it is required for the URL constructor so
+  // we can return a pathname - you can change this if you want, but it isn't
+  // important
+  base = "https://placeholder.com/"
+) {
+  const url = new URL(path, base);
+  const segments = url.pathname.split("/");
+  const isEditorRoute = segments.at(-1) === "edit";
+  const pathname = isEditorRoute
+    ? segments.slice(0, -1).join("/")
+    : url.pathname;
+
+  return {
+    isEditorRoute,
+    path: new URL(pathname, base).pathname,
+  };
+}

package/dist/templates/astro/src/pages/[...puckPath].astro

@@ -0,0 +1,25 @@
+---
+import { getPage } from "../lib/pages";
+import { resolvePuckPath } from "../lib/resolve-puck-path";
+import Editor from "../puck/editor";
+import PuckRender from "../puck/render";
+
+// Pages are loaded when requested, so published changes show up immediately
+export const prerender = false;
+
+const { isEditorRoute, path } = resolvePuckPath(Astro.url.pathname);
+const page = isEditorRoute ? null : await getPage(path);
+
+if (!isEditorRoute && !page) return new Response(null, { status: 404 });
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{isEditorRoute ? `Edit: ${path}` : page?.root.props?.title}</title>
+  </head>
+  <body style={isEditorRoute ? "margin: 0" : undefined}>
+    {isEditorRoute ? <Editor client:only="react" path={path} /> : <PuckRender data={page!} />}
+  </body>
+</html>

package/dist/templates/astro/src/pages/api/pages.ts

@@ -0,0 +1,18 @@
+// Loads and saves Puck pages for the editor
+import type { APIRoute } from "astro";
+import { getPage, savePage } from "../../lib/pages";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ url }) => {
+  const page = await getPage(url.searchParams.get("path") ?? "/");
+  return page
+    ? Response.json(page)
+    : Response.json({ error: "Not found" }, { status: 404 });
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  const { path, data } = await request.json();
+  await savePage(path, data);
+  return Response.json({ status: "ok" });
+};

package/dist/templates/astro/src/puck/editor.tsx

@@ -0,0 +1,32 @@
+import { useEffect, useState } from "react";
+import type { Data } from "@puckeditor/core";
+import { Puck } from "@puckeditor/core";
+import "@puckeditor/core/puck.css";
+
+import { config } from "../puck.config";
+import { loadPage, savePage } from "./pages";
+
+// Empty shell for new pages
+const emptyPage: Data = { content: [], root: { props: { title: "" } } };
+
+// e.g. /edit?path=/about, where there are no server routes for each page
+const pathFromQuery = () =>
+  new URLSearchParams(window.location.search).get("path") ?? "/";
+
+export default function Editor({ path = pathFromQuery() }: { path?: string }) {
+  const [data, setData] = useState<Data | null>(null);
+
+  useEffect(() => {
+    loadPage(path).then((page) => setData(page ?? emptyPage));
+  }, [path]);
+
+  if (!data) return null;
+
+  return (
+    <Puck
+      config={config}
+      data={data}
+      onPublish={(data) => savePage(path, data)}
+    />
+  );
+}

package/dist/templates/astro/src/puck/pages.ts

@@ -0,0 +1,15 @@
+import type { Data } from "@puckeditor/core";
+
+// Loads and saves pages with the pages API in server/puck/pages.ts
+export const loadPage = async (path: string): Promise<Data | null> => {
+  const response = await fetch(`/api/pages?path=${encodeURIComponent(path)}`);
+  return response.ok ? response.json() : null;
+};
+
+export const savePage = async (path: string, data: Data) => {
+  await fetch("/api/pages", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ path, data }),
+  });
+};

package/dist/templates/astro/src/puck/render.tsx

@@ -0,0 +1,9 @@
+import type { Data } from "@puckeditor/core";
+import { Render } from "@puckeditor/core";
+
+import { config } from "../puck.config";
+
+// Rendered on the server, without shipping the editor to the browser
+export default function PuckRender({ data }: { data: Data }) {
+  return <Render config={config} data={data} />;
+}

package/dist/templates/astro/src/puck.config.tsx

@@ -0,0 +1,23 @@
+import type { Config } from "@puckeditor/core";
+
+type Props = {
+  HeadingBlock: { title: string };
+};
+
+export const config: Config<Props> = {
+  components: {
+    HeadingBlock: {
+      fields: {
+        title: { type: "text" },
+      },
+      defaultProps: {
+        title: "Heading",
+      },
+      render: ({ title }) => (
+        <div style={{ padding: 64 }}>
+          <h1>{title}</h1>
+        </div>
+      ),
+    },
+  },
+};

package/dist/templates/astro/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [
+    ".astro/types.d.ts",
+    "**/*"
+  ],
+  "exclude": [
+    "dist"
+  ],
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "react"
+  }
+}

package/dist/templates/astro-ai/README.md

@@ -0,0 +1,64 @@
+# Puck AI + Astro recipe
+
+[Puck](https://puckeditor.com) is the open-source visual editor for React.
+
+This recipe adds Puck and Puck AI to an [Astro](https://astro.build) site. The editor runs as a React island, published pages are rendered on the server, and the [Node adapter](https://docs.astro.build/en/guides/integrations-guide/node/) serves Puck's API routes on demand while the rest of the site can stay static.
+
+## Run the recipe
+
+### 1. Add a Puck API key
+
+Start by creating an account, [generating an API key](https://cloud.puckeditor.com/api-keys), and adding it to an `.env.local` file:
+
+```sh
+PUCK_API_KEY=your-api-key
+```
+
+### 2. Start the development server
+
+Run:
+
+```sh
+npm run dev
+```
+
+Once the server is running, navigate to [http://localhost:4321](http://localhost:4321) to view the home page, or [http://localhost:4321/edit](http://localhost:4321/edit) to edit it with Puck.
+
+### 3. Publish a page
+
+Click the **AI** button in the left sidebar, enter a prompt, and press Enter. Once your page is ready, select **Publish** in the header to save it, then navigate to [http://localhost:4321](http://localhost:4321) to view it.
+
+You can also create a page at any path by navigating to `/your/path/edit` and publishing it.
+
+## How it works
+
+`src/pages/[...puckPath].astro` handles every URL without its own page. When a URL ends in `/edit`, it renders the editor for that path as a client-only React island. Otherwise it loads the published page and renders it with [`<Render>`](https://puckeditor.com/docs/api-reference/components/render) on the server, so no editor code is sent to visitors.
+
+| File                             | Purpose                                                                                            |
+| -------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `src/puck.config.tsx`            | Defines the components, fields, and default props available to Puck. Add your own components here. |
+| `src/pages/[...puckPath].astro`  | Renders the editor at `/edit` URLs, and published pages everywhere else.                           |
+| `src/pages/api/pages.ts`         | Loads and saves pages for the editor.                                                              |
+| `src/pages/api/puck/[...all].ts` | Handles requests from the AI plugin and configures AI generation.                                  |
+| `src/puck/editor.tsx`            | Loads the page being edited and publishes changes.                                                 |
+| `src/puck/render.tsx`            | Renders a published page.                                                                          |
+| `src/lib/pages.ts`               | Reads and writes page data in `database.json`. Replace this with your own database.                |
+| `database.json`                  | Acts as a local database. Replace this with your own database solution.                            |
+
+## Before deploying to production
+
+Before deploying this recipe, make sure to:
+
+- **Protect the editor and APIs.** The `/edit` routes and `/api/pages` and `/api/puck` routes are public by default. Add authentication, authorization, and rate limits.
+- **Add your component library.** Replace the example `HeadingBlock` in `src/puck.config.tsx` with the components and fields your users need.
+- **Set your business context.** Replace the example Google context in `src/pages/api/puck/[...all].ts` with clear information about your product, audience, and content rules.
+- **Set `PUCK_API_KEY` in production.** `.env.local` is only loaded in development, so set it in the environment wherever the server runs.
+- **Use a real database.** Replace `database.json` and `src/lib/pages.ts`. Local files are not reliable across server instances or serverless deployments.
+
+## Learn more
+
+- [Puck documentation](https://puckeditor.com/docs)
+- [Integrating Puck](https://puckeditor.com/docs/integrating-puck/component-configuration)
+- [Puck AI documentation](https://puckeditor.com/docs/ai/overview)
+- [Astro](https://docs.astro.build)
+- [Puck Discord](https://discord.gg/D9e4E3MQVZ)

package/dist/templates/astro-ai/_gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/

package/dist/templates/astro-ai/astro.config.mjs

@@ -0,0 +1,21 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+
+import react from "@astrojs/react";
+import node from "@astrojs/node";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [react()],
+
+  adapter: node({
+    mode: "standalone",
+  }),
+
+  // Pre-bundle Puck together, so the AI plugin and the editor share one copy
+  vite: {
+    optimizeDeps: {
+      include: ["@puckeditor/core", "@puckeditor/plugin-ai"],
+    },
+  },
+});

package/dist/templates/astro-ai/database.json

@@ -0,0 +1 @@
+{"/":{"content":[{"type":"HeadingBlock","props":{"title":"Edit this page by adding /edit to the end of the URL","id":"HeadingBlock-1694032984497"}}],"root":{"props": {"title":""}}}}

package/dist/templates/astro-ai/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "astro-ai-recipe",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "start": "node dist/server/entry.mjs",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/node": "^11.1.6",
+    "@astrojs/react": "^7.0.0",
+    "@puckeditor/cloud-client": "^0",
+    "@puckeditor/core": "workspace:*",
+    "@puckeditor/plugin-ai": "^0",
+    "astro": "^7.3.5",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0"
+  }
+}

package/dist/templates/astro-ai/public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

package/dist/templates/astro-ai/src/lib/pages.ts

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+import type { Data } from "@puckeditor/core";
+
+// Replace this with your own database
+const databasePath = "database.json";
+
+const readPages = async (): Promise<Record<string, Data>> => {
+  try {
+    return JSON.parse(await fs.readFile(databasePath, "utf-8"));
+  } catch {
+    return {};
+  }
+};
+
+export const getPage = async (path: string) => (await readPages())[path];
+
+export const savePage = async (path: string, data: Data) => {
+  const pages = await readPages();
+  pages[path] = data;
+  await fs.writeFile(databasePath, JSON.stringify(pages));
+};

package/dist/templates/astro-ai/src/lib/resolve-puck-path.ts

@@ -0,0 +1,19 @@
+export function resolvePuckPath(
+  path = "",
+  // `base` can be any valid origin, it is required for the URL constructor so
+  // we can return a pathname - you can change this if you want, but it isn't
+  // important
+  base = "https://placeholder.com/"
+) {
+  const url = new URL(path, base);
+  const segments = url.pathname.split("/");
+  const isEditorRoute = segments.at(-1) === "edit";
+  const pathname = isEditorRoute
+    ? segments.slice(0, -1).join("/")
+    : url.pathname;
+
+  return {
+    isEditorRoute,
+    path: new URL(pathname, base).pathname,
+  };
+}

package/dist/templates/astro-ai/src/pages/[...puckPath].astro

@@ -0,0 +1,25 @@
+---
+import { getPage } from "../lib/pages";
+import { resolvePuckPath } from "../lib/resolve-puck-path";
+import Editor from "../puck/editor";
+import PuckRender from "../puck/render";
+
+// Pages are loaded when requested, so published changes show up immediately
+export const prerender = false;
+
+const { isEditorRoute, path } = resolvePuckPath(Astro.url.pathname);
+const page = isEditorRoute ? null : await getPage(path);
+
+if (!isEditorRoute && !page) return new Response(null, { status: 404 });
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{isEditorRoute ? `Edit: ${path}` : page?.root.props?.title}</title>
+  </head>
+  <body style={isEditorRoute ? "margin: 0" : undefined}>
+    {isEditorRoute ? <Editor client:only="react" path={path} /> : <PuckRender data={page!} />}
+  </body>
+</html>

package/dist/templates/astro-ai/src/pages/api/pages.ts

@@ -0,0 +1,18 @@
+// Loads and saves Puck pages for the editor
+import type { APIRoute } from "astro";
+import { getPage, savePage } from "../../lib/pages";
+
+export const prerender = false;
+
+export const GET: APIRoute = async ({ url }) => {
+  const page = await getPage(url.searchParams.get("path") ?? "/");
+  return page
+    ? Response.json(page)
+    : Response.json({ error: "Not found" }, { status: 404 });
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  const { path, data } = await request.json();
+  await savePage(path, data);
+  return Response.json({ status: "ok" });
+};