kunthawat/moreminimore-redesign
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Activity

Format

Browse Source
This commit is contained in:
Matt Kane
2026-04-01 11:51:57 +01:00
parent c8e318da5c
commit ca3c2b77e1
88 changed files with 313 additions and 481 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
AGENTS.md
View File

@@ -97,7 +97,7 @@ EmDash is an Astro-native CMS that stores its schema in the database, not in cod
| File | Purpose | | File | Purpose |
| ----------------------------------- | ----------------------------------------------------- | | ----------------------------------- | ----------------------------------------------------- |
| `src/live.config.ts` | Collection schemas + admin config (user's site) | | `src/live.config.ts` | Collection schemas + admin config (user's site) |
| `src/emdash-runtime.ts` | Central runtime; orchestrates DB, plugins, storage | | `src/emdash-runtime.ts` | Central runtime; orchestrates DB, plugins, storage |
| `src/schema/registry.ts` | Manages `ec_*` table creation/modification | | `src/schema/registry.ts` | Manages `ec_*` table creation/modification |
| `src/database/migrations/runner.ts` | StaticMigrationProvider; register new migrations here | | `src/database/migrations/runner.ts` | StaticMigrationProvider; register new migrations here |
| `src/plugins/manager.ts` | Loads and orchestrates trusted plugins | | `src/plugins/manager.ts` | Loads and orchestrates trusted plugins |

4
CONTRIBUTING.md
View File

@@ -51,8 +51,8 @@ pnpm --filter @emdash-cms/template-portfolio dev
Available templates: Available templates:
| Template | Filter Name | | Template | Filter Name |
| --------- | ------------------------------ | | --------- | -------------------------------- |
| Blog | `@emdash-cms/template-blog` | | Blog | `@emdash-cms/template-blog` |
| Portfolio | `@emdash-cms/template-portfolio` | | Portfolio | `@emdash-cms/template-portfolio` |
| Marketing | `@emdash-cms/template-marketing` | | Marketing | `@emdash-cms/template-marketing` |

7
demos/cloudflare/tsconfig.json
View File

@@ -1,9 +1,4 @@
{ {
"extends": "astro/tsconfigs/strict", "extends": "astro/tsconfigs/strict",
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts", "worker-configuration.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts",
"worker-configuration.d.ts"
]
} }

7
demos/cloudflare/wrangler.jsonc
View File

@@ -5,10 +5,7 @@
"compatibility_date": "2026-01-14", "compatibility_date": "2026-01-14",
// disable_nodejs_process_v2 needed until unenv fix lands in Pages // disable_nodejs_process_v2 needed until unenv fix lands in Pages
// See: https://github.com/withastro/astro/issues/14511 // See: https://github.com/withastro/astro/issues/14511
"compatibility_flags": [ "compatibility_flags": ["nodejs_compat", "disable_nodejs_process_v2"],
"nodejs_compat",
"disable_nodejs_process_v2"
],
// Static assets served from dist/ // Static assets served from dist/
"assets": { "assets": {
"directory": "./dist", "directory": "./dist",
@@ -24,7 +21,7 @@
"d1_databases": [ "d1_databases": [
{ {
"binding": "DB", "binding": "DB",
"database_name": "emdash_db" "database_name": "emdash_db",
}, },
], ],
// R2 bucket for media storage // R2 bucket for media storage

10
demos/playground/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

8
demos/playground/wrangler.jsonc
View File

@@ -2,9 +2,7 @@
"$schema": "node_modules/wrangler/config-schema.json", "$schema": "node_modules/wrangler/config-schema.json",
"name": "emdash-playground", "name": "emdash-playground",
"compatibility_date": "2026-02-24", "compatibility_date": "2026-02-24",
"compatibility_flags": [ "compatibility_flags": ["nodejs_compat"],
"nodejs_compat"
],
// Custom entrypoint that exports EmDashPreviewDB // Custom entrypoint that exports EmDashPreviewDB
"main": "./src/worker.ts", "main": "./src/worker.ts",
"assets": { "assets": {
@@ -21,9 +19,7 @@
"migrations": [ "migrations": [
{ {
"tag": "v1", "tag": "v1",
"new_sqlite_classes": [ "new_sqlite_classes": ["EmDashPreviewDB"],
"EmDashPreviewDB"
],
}, },
], ],
"observability": { "observability": {

6
demos/plugins-demo/tsconfig.json
View File

@@ -3,9 +3,5 @@
"compilerOptions": { "compilerOptions": {
"strictNullChecks": true "strictNullChecks": true
}, },
"include": [ "include": ["src/**/*", "astro.config.mjs", "emdash-env.d.ts"]
"src/**/*",
"astro.config.mjs",
"emdash-env.d.ts"
]
} }

10
demos/postgres/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

7
demos/preview/tsconfig.json
View File

@@ -1,9 +1,4 @@
{ {
"extends": "astro/tsconfigs/strict", "extends": "astro/tsconfigs/strict",
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts", "worker-configuration.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts",
"worker-configuration.d.ts"
]
} }

9
demos/preview/wrangler.jsonc
View File

@@ -4,10 +4,7 @@
// Custom entrypoint that exports EmDashPreviewDB // Custom entrypoint that exports EmDashPreviewDB
"main": "./src/worker.ts", "main": "./src/worker.ts",
"compatibility_date": "2026-01-14", "compatibility_date": "2026-01-14",
"compatibility_flags": [ "compatibility_flags": ["nodejs_compat", "disable_nodejs_process_v2"],
"nodejs_compat",
"disable_nodejs_process_v2"
],
"assets": { "assets": {
"directory": "./dist", "directory": "./dist",
}, },
@@ -24,9 +21,7 @@
"migrations": [ "migrations": [
{ {
"tag": "v1", "tag": "v1",
"new_sqlite_classes": [ "new_sqlite_classes": ["EmDashPreviewDB"],
"EmDashPreviewDB"
],
}, },
], ],
"observability": { "observability": {

10
demos/simple/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

24
e2e/tests/allowed-domains.spec.ts
View File

@@ -109,10 +109,10 @@ test.describe("Allowed Domains Settings", () => {
await expect(successMsg).toBeVisible({ timeout: 5000 }); await expect(successMsg).toBeVisible({ timeout: 5000 });
// Clean up via API // Clean up via API
await fetch( await fetch(`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, {
`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, method: "DELETE",
{ method: "DELETE", headers }, headers,
).catch(() => {}); }).catch(() => {});
}); });
test("removes a domain via the UI", async ({ admin, page }) => { test("removes a domain via the UI", async ({ admin, page }) => {
@@ -193,10 +193,10 @@ test.describe("Allowed Domains Settings", () => {
await expect(page.locator(`.font-medium`, { hasText: testDomain })).toBeVisible(); await expect(page.locator(`.font-medium`, { hasText: testDomain })).toBeVisible();
// Clean up // Clean up
await fetch( await fetch(`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, {
`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, method: "DELETE",
{ method: "DELETE", headers }, headers,
).catch(() => {}); }).catch(() => {});
}); });
test("toggling enabled/disabled updates the domain", async ({ admin, page }) => { test("toggling enabled/disabled updates the domain", async ({ admin, page }) => {
@@ -228,9 +228,9 @@ test.describe("Allowed Domains Settings", () => {
await expect(statusMsg).toBeVisible({ timeout: 5000 }); await expect(statusMsg).toBeVisible({ timeout: 5000 });
// Clean up // Clean up
await fetch( await fetch(`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, {
`${baseUrl}/_emdash/api/admin/allowed-domains/${encodeURIComponent(testDomain)}`, method: "DELETE",
{ method: "DELETE", headers }, headers,
).catch(() => {}); }).catch(() => {});
}); });
}); });

11
e2e/tests/revisions.spec.ts
View File

@@ -342,13 +342,10 @@ test.describe("Revisions", () => {
const olderRevisionId = revisions[1].id; const olderRevisionId = revisions[1].id;
// Restore via API // Restore via API
const restoreRes = await fetch( const restoreRes = await fetch(`${baseUrl}/_emdash/api/revisions/${olderRevisionId}/restore`, {
`${baseUrl}/_emdash/api/revisions/${olderRevisionId}/restore`, method: "POST",
{ headers,
method: "POST", });
headers,
},
);
expect(restoreRes.status).toBe(200); expect(restoreRes.status).toBe(200);
// Get revision count after restore -- should have increased // Get revision count after restore -- should have increased

6
e2e/tests/search.spec.ts
View File

@@ -272,11 +272,7 @@ test.describe("Search", () => {
// TODO: getSuggestions fails in dev mode -- needs investigation // TODO: getSuggestions fails in dev mode -- needs investigation
await enableSearch(serverInfo, "posts"); await enableSearch(serverInfo, "posts");
const res = await apiRequest( const res = await apiRequest(serverInfo, "GET", "/_emdash/api/search/suggest?q=Fir&limit=5");
serverInfo,
"GET",
"/_emdash/api/search/suggest?q=Fir&limit=5",
);
expect(res.status).toBe(200); expect(res.status).toBe(200);
const body = await res.json(); const body = await res.json();

4
packages/admin/src/components/MarketplacePluginDetail.tsx
View File

@@ -329,9 +329,7 @@ export function MarketplacePluginDetail({
<h3 className="text-sm font-semibold mb-2">Version</h3> <h3 className="text-sm font-semibold mb-2">Version</h3>
<div className="space-y-1 text-xs text-kumo-subtle"> <div className="space-y-1 text-xs text-kumo-subtle">
<div>v{latest.version}</div> <div>v{latest.version}</div>
{latest.minEmDashVersion && ( {latest.minEmDashVersion && <div>Requires EmDash {latest.minEmDashVersion}</div>}
<div>Requires EmDash {latest.minEmDashVersion}</div>
)}
<div>Published {new Date(latest.publishedAt).toLocaleDateString()}</div> <div>Published {new Date(latest.publishedAt).toLocaleDateString()}</div>
{latest.bundleSize > 0 && <div>{formatBytes(latest.bundleSize)}</div>} {latest.bundleSize > 0 && <div>{formatBytes(latest.bundleSize)}</div>}
</div> </div>

2
packages/admin/src/components/PortableTextEditor.tsx
View File

@@ -12,6 +12,7 @@
*/ */
import { Button, Dialog, Input } from "@cloudflare/kumo"; import { Button, Dialog, Input } from "@cloudflare/kumo";
import type { Element } from "@emdash-cms/blocks";
import { useFloating, offset, flip, shift, autoUpdate } from "@floating-ui/react"; import { useFloating, offset, flip, shift, autoUpdate } from "@floating-ui/react";
import { import {
TextB, TextB,
@@ -41,7 +42,6 @@ import {
type Icon, type Icon,
} from "@phosphor-icons/react"; } from "@phosphor-icons/react";
import { X } from "@phosphor-icons/react"; import { X } from "@phosphor-icons/react";
import type { Element } from "@emdash-cms/blocks";
import { Extension, type Range } from "@tiptap/core"; import { Extension, type Range } from "@tiptap/core";
import CharacterCount from "@tiptap/extension-character-count"; import CharacterCount from "@tiptap/extension-character-count";
import Focus from "@tiptap/extension-focus"; import Focus from "@tiptap/extension-focus";

2
packages/admin/src/components/SandboxedPluginPage.tsx
View File

@@ -5,9 +5,9 @@
* interactions to the plugin's admin route and renders the returned blocks. * interactions to the plugin's admin route and renders the returned blocks.
*/ */
import { CircleNotch, WarningCircle } from "@phosphor-icons/react";
import { BlockRenderer } from "@emdash-cms/blocks"; import { BlockRenderer } from "@emdash-cms/blocks";
import type { Block, BlockInteraction, BlockResponse } from "@emdash-cms/blocks"; import type { Block, BlockInteraction, BlockResponse } from "@emdash-cms/blocks";
import { CircleNotch, WarningCircle } from "@phosphor-icons/react";
import { useCallback, useEffect, useState } from "react"; import { useCallback, useEffect, useState } from "react";
import { apiFetch, API_BASE } from "../lib/api/client.js"; import { apiFetch, API_BASE } from "../lib/api/client.js";

2
packages/admin/src/components/SandboxedPluginWidget.tsx
View File

@@ -5,9 +5,9 @@
* interaction with page="widget:<widgetId>" to the plugin's admin route. * interaction with page="widget:<widgetId>" to the plugin's admin route.
*/ */
import { CircleNotch } from "@phosphor-icons/react";
import { BlockRenderer } from "@emdash-cms/blocks"; import { BlockRenderer } from "@emdash-cms/blocks";
import type { Block, BlockInteraction, BlockResponse } from "@emdash-cms/blocks"; import type { Block, BlockInteraction, BlockResponse } from "@emdash-cms/blocks";
import { CircleNotch } from "@phosphor-icons/react";
import { useCallback, useEffect, useState } from "react"; import { useCallback, useEffect, useState } from "react";
import { apiFetch, API_BASE } from "../lib/api/client.js"; import { apiFetch, API_BASE } from "../lib/api/client.js";

4
packages/admin/src/components/WordPressImport.tsx
View File

@@ -720,9 +720,7 @@ export function WordPressImport() {
<div className="rounded-lg border bg-kumo-base p-12 text-center"> <div className="rounded-lg border bg-kumo-base p-12 text-center">
<Loader /> <Loader />
<p className="mt-4 text-kumo-subtle">Analyzing WordPress site...</p> <p className="mt-4 text-kumo-subtle">Analyzing WordPress site...</p>
<p className="text-sm text-kumo-subtle"> <p className="text-sm text-kumo-subtle">Fetching content from the EmDash Exporter API.</p>
Fetching content from the EmDash Exporter API.
</p>
</div> </div>
)} )}

2
packages/admin/src/components/editor/PluginBlockNode.tsx
View File

@@ -10,6 +10,7 @@
*/ */
import { Button, Input } from "@cloudflare/kumo"; import { Button, Input } from "@cloudflare/kumo";
import type { Element } from "@emdash-cms/blocks";
import { import {
DotsSixVertical, DotsSixVertical,
Trash, Trash,
@@ -24,7 +25,6 @@ import {
Cube, Cube,
ListBullets, ListBullets,
} from "@phosphor-icons/react"; } from "@phosphor-icons/react";
import type { Element } from "@emdash-cms/blocks";
import { Node, mergeAttributes } from "@tiptap/core"; import { Node, mergeAttributes } from "@tiptap/core";
import type { NodeViewProps } from "@tiptap/react"; import type { NodeViewProps } from "@tiptap/react";
import { ReactNodeViewRenderer, NodeViewWrapper } from "@tiptap/react"; import { ReactNodeViewRenderer, NodeViewWrapper } from "@tiptap/react";

8
packages/admin/tests/lib/url.test.ts
View File

@@ -18,9 +18,7 @@ describe("sanitizeRedirectUrl", () => {
}); });
it("allows paths with query strings", () => { it("allows paths with query strings", () => {
expect(sanitizeRedirectUrl("/_emdash/admin?tab=settings")).toBe( expect(sanitizeRedirectUrl("/_emdash/admin?tab=settings")).toBe("/_emdash/admin?tab=settings");
"/_emdash/admin?tab=settings",
);
}); });
it("allows paths with hash fragments", () => { it("allows paths with hash fragments", () => {
@@ -44,9 +42,7 @@ describe("sanitizeRedirectUrl", () => {
}); });
it("rejects data: scheme", () => { it("rejects data: scheme", () => {
expect(sanitizeRedirectUrl("data:text/html,<script>alert(1)</script>")).toBe( expect(sanitizeRedirectUrl("data:text/html,<script>alert(1)</script>")).toBe("/_emdash/admin");
"/_emdash/admin",
);
}); });
it("rejects backslash trick (/\\evil.com)", () => { it("rejects backslash trick (/\\evil.com)", () => {

2
packages/blocks/playground/src/Playground.tsx
View File

@@ -1,6 +1,6 @@
import { Sun, Moon, Share, Check, Trash, CaretDown, Warning, Plus } from "@phosphor-icons/react";
import { BlockRenderer, validateBlocks } from "@emdash-cms/blocks"; import { BlockRenderer, validateBlocks } from "@emdash-cms/blocks";
import type { Block, BlockInteraction } from "@emdash-cms/blocks"; import type { Block, BlockInteraction } from "@emdash-cms/blocks";
import { Sun, Moon, Share, Check, Trash, CaretDown, Warning, Plus } from "@phosphor-icons/react";
import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { blockCatalog } from "./block-defaults"; import { blockCatalog } from "./block-defaults";

2
packages/cloudflare/src/auth/cloudflare-access.ts
View File

@@ -10,8 +10,8 @@
* Do not import at config time. * Do not import at config time.
*/ */
import { createRemoteJWKSet, jwtVerify, type JWTPayload } from "jose";
import type { AuthResult } from "emdash"; import type { AuthResult } from "emdash";
import { createRemoteJWKSet, jwtVerify, type JWTPayload } from "jose";
/** /**
* Configuration for Cloudflare Access authentication * Configuration for Cloudflare Access authentication

2
packages/cloudflare/src/db/do-preview.ts
View File

@@ -22,8 +22,8 @@
import type { MiddlewareHandler } from "astro"; import type { MiddlewareHandler } from "astro";
import { env } from "cloudflare:workers"; import { env } from "cloudflare:workers";
import { Kysely } from "kysely";
import { runWithContext } from "emdash/request-context"; import { runWithContext } from "emdash/request-context";
import { Kysely } from "kysely";
import { ulid } from "ulidx"; import { ulid } from "ulidx";
import type { EmDashPreviewDB } from "./do-class.js"; import type { EmDashPreviewDB } from "./do-class.js";

12
packages/cloudflare/src/storage/r2.ts
View File

@@ -61,11 +61,7 @@ export class R2Storage implements Storage {
}; };
} catch (error) { } catch (error) {
if (error instanceof EmDashStorageError) throw error; if (error instanceof EmDashStorageError) throw error;
throw new EmDashStorageError( throw new EmDashStorageError(`Failed to upload file: ${options.key}`, "UPLOAD_FAILED", error);
`Failed to upload file: ${options.key}`,
"UPLOAD_FAILED",
error,
);
} }
} }
@@ -107,11 +103,7 @@ export class R2Storage implements Storage {
const object = await this.bucket.head(key); const object = await this.bucket.head(key);
return object !== null; return object !== null;
} catch (error) { } catch (error) {
throw new EmDashStorageError( throw new EmDashStorageError(`Failed to check file existence: ${key}`, "HEAD_FAILED", error);
`Failed to check file existence: ${key}`,
"HEAD_FAILED",
error,
);
} }
} }

5
packages/core/src/api/handlers/device-flow.ts
View File

@@ -664,10 +664,7 @@ export async function handleTokenRevoke(
if (row.token_type === "refresh") { if (row.token_type === "refresh") {
// Revoke refresh token and all its access tokens // Revoke refresh token and all its access tokens
await db await db.deleteFrom("_emdash_oauth_tokens").where("refresh_token_hash", "=", hash).execute();
.deleteFrom("_emdash_oauth_tokens")
.where("refresh_token_hash", "=", hash)
.execute();
await db.deleteFrom("_emdash_oauth_tokens").where("token_hash", "=", hash).execute(); await db.deleteFrom("_emdash_oauth_tokens").where("token_hash", "=", hash).execute();
} else { } else {
// Revoke just the access token // Revoke just the access token

6
packages/core/src/api/handlers/oauth-clients.ts
View File

@@ -236,11 +236,7 @@ export async function handleOAuthClientUpdate(
updates.scopes = input.scopes ? JSON.stringify(input.scopes) : ""; updates.scopes = input.scopes ? JSON.stringify(input.scopes) : "";
} }
await db await db.updateTable("_emdash_oauth_clients").set(updates).where("id", "=", clientId).execute();
.updateTable("_emdash_oauth_clients")
.set(updates)
.where("id", "=", clientId)
.execute();
// Fetch the updated row // Fetch the updated row
const updated = await db const updated = await db

6
packages/core/src/astro/routes/api/admin/comments/[id]/status.ts
View File

@@ -95,11 +95,7 @@ export const PUT: APIRoute = async ({ params, request, locals }) => {
if (newStatus === "approved" && previousStatus !== "approved" && emdash.email) { if (newStatus === "approved" && previousStatus !== "approved" && emdash.email) {
try { try {
const adminBaseUrl = await getSiteBaseUrl(emdash.db, request); const adminBaseUrl = await getSiteBaseUrl(emdash.db, request);
const content = await lookupContentAuthor( const content = await lookupContentAuthor(emdash.db, updated.collection, updated.contentId);
emdash.db,
updated.collection,
updated.contentId,
);
if (content?.author) { if (content?.author) {
await sendCommentNotification({ await sendCommentNotification({
email: emdash.email, email: emdash.email,

4
packages/core/src/astro/routes/api/auth/passkey/register/verify.ts
View File

@@ -71,9 +71,7 @@ export const POST: APIRoute = async ({ request, locals }) => {
// Get passkey name - prefer body.name, then check stored pending name // Get passkey name - prefer body.name, then check stored pending name
let passKeyName: string | undefined = body.name ?? undefined; let passKeyName: string | undefined = body.name ?? undefined;
if (!passKeyName) { if (!passKeyName) {
const pending = await optionsRepo.get<{ name?: string }>( const pending = await optionsRepo.get<{ name?: string }>(`emdash:passkey_pending:${user.id}`);
`emdash:passkey_pending:${user.id}`,
);
if (pending?.name) { if (pending?.name) {
passKeyName = pending.name; passKeyName = pending.name;
} }

6
packages/core/src/astro/routes/api/content/[collection]/[id]/schedule.ts
View File

@@ -59,11 +59,7 @@ export const POST: APIRoute = async ({ params, request, locals, cache }) => {
const denied = requireOwnerPerm(user, authorId, "content:publish_own", "content:publish_any"); const denied = requireOwnerPerm(user, authorId, "content:publish_own", "content:publish_any");
if (denied) return denied; if (denied) return denied;
const result = await emdash.handleContentSchedule( const result = await emdash.handleContentSchedule(collection, resolvedId ?? id, body.scheduledAt);
collection,
resolvedId ?? id,
body.scheduledAt,
);
if (!result.success) return unwrapResult(result); if (!result.success) return unwrapResult(result);

2
packages/core/src/astro/routes/api/import/wordpress/analyze.ts
View File

@@ -8,8 +8,8 @@
*/ */
import type { APIRoute } from "astro"; import type { APIRoute } from "astro";
import mime from "mime/lite";
import { parseWxrString, SchemaRegistry, type WxrData } from "emdash"; import { parseWxrString, SchemaRegistry, type WxrData } from "emdash";
import mime from "mime/lite";
import { requirePerm } from "#api/authorize.js"; import { requirePerm } from "#api/authorize.js";
import { apiError, apiSuccess, handleError } from "#api/error.js"; import { apiError, apiSuccess, handleError } from "#api/error.js";

2
packages/core/src/astro/routes/api/import/wordpress/media.ts
View File

@@ -11,8 +11,8 @@
import * as path from "node:path"; import * as path from "node:path";
import type { APIRoute } from "astro"; import type { APIRoute } from "astro";
import mime from "mime/lite";
import { MediaRepository, computeContentHash } from "emdash"; import { MediaRepository, computeContentHash } from "emdash";
import mime from "mime/lite";
import { ulid } from "ulidx"; import { ulid } from "ulidx";
import { requirePerm } from "#api/authorize.js"; import { requirePerm } from "#api/authorize.js";

6
packages/core/src/astro/routes/api/revisions/[revisionId]/restore.ts
View File

@@ -15,11 +15,7 @@ export const POST: APIRoute = async ({ params, locals }) => {
const { emdash, user } = locals; const { emdash, user } = locals;
const revisionId = params.revisionId!; const revisionId = params.revisionId!;
if ( if (!emdash?.handleRevisionRestore || !emdash?.handleRevisionGet || !emdash?.handleContentGet) {
!emdash?.handleRevisionRestore ||
!emdash?.handleRevisionGet ||
!emdash?.handleContentGet
) {
return apiError("NOT_CONFIGURED", "EmDash not configured", 500); return apiError("NOT_CONFIGURED", "EmDash not configured", 500);
} }

6
packages/core/src/astro/routes/api/widget-areas/[name]/reorder.ts
View File

@@ -57,11 +57,7 @@ export const POST: APIRoute = async ({ params, request, locals }) => {
// Update sort_order for each widget // Update sort_order for each widget
await Promise.all( await Promise.all(
body.widgetIds.map((id, index) => body.widgetIds.map((id, index) =>
db db.updateTable("_emdash_widgets").set({ sort_order: index }).where("id", "=", id).execute(),
.updateTable("_emdash_widgets")
.set({ sort_order: index })
.where("id", "=", id)
.execute(),
), ),
); );

4
packages/core/src/cli/commands/publish.ts
View File

@@ -418,9 +418,7 @@ export const publishCommand = defineCommand({
process.exit(1); process.exit(1);
} }
} catch { } catch {
consola.error( consola.error("No dist/ directory found. Run `emdash plugin bundle` first or use --build.");
"No dist/ directory found. Run `emdash plugin bundle` first or use --build.",
);
process.exit(1); process.exit(1);
} }
} }

4
packages/core/src/cli/commands/seed.ts
View File

@@ -135,9 +135,7 @@ export const seedCommand = defineCommand({
const seedPath = await resolveSeedPath(cwd, args.path); const seedPath = await resolveSeedPath(cwd, args.path);
if (!seedPath) { if (!seedPath) {
consola.error("No seed file found"); consola.error("No seed file found");
consola.info( consola.info("Provide a path, create .emdash/seed.json, or set emdash.seed in package.json");
"Provide a path, create .emdash/seed.json, or set emdash.seed in package.json",
);
process.exit(1); process.exit(1);
} }

5
packages/core/src/database/migrations/032_rate_limits.ts
View File

@@ -27,10 +27,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
.execute(); .execute();
// ── Device code polling tracking ───────────────────────────────── // ── Device code polling tracking ─────────────────────────────────
await db.schema await db.schema.alterTable("_emdash_device_codes").addColumn("last_polled_at", "text").execute();
.alterTable("_emdash_device_codes")
.addColumn("last_polled_at", "text")
.execute();
} }
export async function down(db: Kysely<unknown>): Promise<void> { export async function down(db: Kysely<unknown>): Promise<void> {

4
packages/core/src/mcp/server.ts
View File

@@ -9,10 +9,10 @@
* The handlers instance is passed per-request via authInfo on the transport. * The handlers instance is passed per-request via authInfo on the transport.
*/ */
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
import type { Permission, RoleLevel } from "@emdash-cms/auth"; import type { Permission, RoleLevel } from "@emdash-cms/auth";
import { canActOnOwn, Role } from "@emdash-cms/auth"; import { canActOnOwn, Role } from "@emdash-cms/auth";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
import { z } from "zod"; import { z } from "zod";
import type { EmDashHandlers } from "../astro/types.js"; import type { EmDashHandlers } from "../astro/types.js";

6
packages/core/src/storage/local.ts
View File

@@ -103,11 +103,7 @@ export class LocalStorage implements Storage {
size: buffer.length, size: buffer.length,
}; };
} catch (error) { } catch (error) {
throw new EmDashStorageError( throw new EmDashStorageError(`Failed to upload file: ${options.key}`, "UPLOAD_FAILED", error);
`Failed to upload file: ${options.key}`,
"UPLOAD_FAILED",
error,
);
} }
} }

12
packages/core/src/storage/s3.ts
View File

@@ -97,11 +97,7 @@ export class S3Storage implements Storage {
size: body.length, size: body.length,
}; };
} catch (error) { } catch (error) {
throw new EmDashStorageError( throw new EmDashStorageError(`Failed to upload file: ${options.key}`, "UPLOAD_FAILED", error);
`Failed to upload file: ${options.key}`,
"UPLOAD_FAILED",
error,
);
} }
} }
@@ -166,11 +162,7 @@ export class S3Storage implements Storage {
if (hasErrorName(error) && error.name === "NotFound") { if (hasErrorName(error) && error.name === "NotFound") {
return false; return false;
} }
throw new EmDashStorageError( throw new EmDashStorageError(`Failed to check file existence: ${key}`, "HEAD_FAILED", error);
`Failed to check file existence: ${key}`,
"HEAD_FAILED",
error,
);
} }
} }

30
packages/core/tests/integration/auth/device-flow.test.ts
View File

@@ -172,11 +172,7 @@ describe("Device Flow: Full Lifecycle", () => {
}); });
it("should handle denied authorization", async () => { it("should handle denied authorization", async () => {
const codeResult = await handleDeviceCodeRequest( const codeResult = await handleDeviceCodeRequest(db, {}, "https://example.com/_emdash/device");
db,
{},
"https://example.com/_emdash/device",
);
expect(codeResult.success).toBe(true); expect(codeResult.success).toBe(true);
if (!codeResult.success) return; if (!codeResult.success) return;
@@ -199,11 +195,7 @@ describe("Device Flow: Full Lifecycle", () => {
}); });
it("should normalize user codes (strip hyphens, case-insensitive)", async () => { it("should normalize user codes (strip hyphens, case-insensitive)", async () => {
const codeResult = await handleDeviceCodeRequest( const codeResult = await handleDeviceCodeRequest(db, {}, "https://example.com/_emdash/device");
db,
{},
"https://example.com/_emdash/device",
);
expect(codeResult.success).toBe(true); expect(codeResult.success).toBe(true);
if (!codeResult.success) return; if (!codeResult.success) return;
@@ -263,11 +255,7 @@ describe("Device Token Exchange: Error Cases", () => {
describe("Token Refresh", () => { describe("Token Refresh", () => {
it("should exchange a refresh token for a new access token", async () => { it("should exchange a refresh token for a new access token", async () => {
// Complete a device flow first to get tokens // Complete a device flow first to get tokens
const codeResult = await handleDeviceCodeRequest( const codeResult = await handleDeviceCodeRequest(db, {}, "https://example.com/_emdash/device");
db,
{},
"https://example.com/_emdash/device",
);
expect(codeResult.success).toBe(true); expect(codeResult.success).toBe(true);
if (!codeResult.success) return; if (!codeResult.success) return;
@@ -330,11 +318,7 @@ describe("Token Refresh", () => {
describe("Token Revoke", () => { describe("Token Revoke", () => {
it("should revoke an access token", async () => { it("should revoke an access token", async () => {
// Get tokens via device flow // Get tokens via device flow
const codeResult = await handleDeviceCodeRequest( const codeResult = await handleDeviceCodeRequest(db, {}, "https://example.com/_emdash/device");
db,
{},
"https://example.com/_emdash/device",
);
if (!codeResult.success) return; if (!codeResult.success) return;
await handleDeviceAuthorize(db, "user-1", Role.ADMIN, { await handleDeviceAuthorize(db, "user-1", Role.ADMIN, {
@@ -365,11 +349,7 @@ describe("Token Revoke", () => {
it("should revoke a refresh token and its access tokens", async () => { it("should revoke a refresh token and its access tokens", async () => {
// Get tokens via device flow // Get tokens via device flow
const codeResult = await handleDeviceCodeRequest( const codeResult = await handleDeviceCodeRequest(db, {}, "https://example.com/_emdash/device");
db,
{},
"https://example.com/_emdash/device",
);
if (!codeResult.success) return; if (!codeResult.success) return;
await handleDeviceAuthorize(db, "user-1", Role.ADMIN, { await handleDeviceAuthorize(db, "user-1", Role.ADMIN, {

4
packages/core/tests/unit/mcp/authorization.test.ts
View File

@@ -8,10 +8,10 @@
* authInfo to simulate different users and roles. * authInfo to simulate different users and roles.
*/ */
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
import { Role } from "@emdash-cms/auth"; import { Role } from "@emdash-cms/auth";
import type { RoleLevel } from "@emdash-cms/auth"; import type { RoleLevel } from "@emdash-cms/auth";
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
import { afterEach, describe, expect, it, vi } from "vitest"; import { afterEach, describe, expect, it, vi } from "vitest";
import type { EmDashHandlers } from "../../../src/astro/types.js"; import type { EmDashHandlers } from "../../../src/astro/types.js";

5
packages/core/tests/unit/media/normalize.test.ts
View File

@@ -77,10 +77,7 @@ describe("normalizeMediaValue", () => {
}); });
it("falls back to external for internal URL when local provider unavailable", async () => { it("falls back to external for internal URL when local provider unavailable", async () => {
const result = await normalizeMediaValue( const result = await normalizeMediaValue("/_emdash/api/media/file/01ABC.jpg", getProvider({}));
"/_emdash/api/media/file/01ABC.jpg",
getProvider({}),
);
expect(result).toEqual({ expect(result).toEqual({
provider: "external", provider: "external",
id: "", id: "",

20
skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

38
skills/wordpress-plugin-to-emdash/SKILL.md
View File

@@ -20,44 +20,44 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Content & Data ### Content & Data
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ----------------------- | ------------------------------------------- | --------------------------------------------- | | ----------------------- | ----------------------------------------- | --------------------------------------------- |
| `register_post_type()` | `SchemaRegistry.createCollection()` | Via Admin API or seed file | | `register_post_type()` | `SchemaRegistry.createCollection()` | Via Admin API or seed file |
| `register_taxonomy()` | `_emdash_taxonomy_defs` table | Hierarchical or flat, attached to collections | | `register_taxonomy()` | `_emdash_taxonomy_defs` table | Hierarchical or flat, attached to collections |
| `register_meta()` / ACF | Collection fields via SchemaRegistry | All become typed schema fields | | `register_meta()` / ACF | Collection fields via SchemaRegistry | All become typed schema fields |
| `get_post_meta()` | `entry.data.fieldName` | Direct typed access | | `get_post_meta()` | `entry.data.fieldName` | Direct typed access |
| `get_option()` | `getSiteSetting()` / `ctx.kv` | Site settings or plugin-namespaced KV | | `get_option()` | `getSiteSetting()` / `ctx.kv` | Site settings or plugin-namespaced KV |
| `WP_Query` | `getEmDashCollection()` | Runtime queries with filters | | `WP_Query` | `getEmDashCollection()` | Runtime queries with filters |
| `get_post($id)` | `getEmDashEntry(collection, slug)` | Returns entry or null | | `get_post($id)` | `getEmDashEntry(collection, slug)` | Returns entry or null |
| `wp_insert_post()` | `POST /_emdash/api/content/{type}` | REST API | | `wp_insert_post()` | `POST /_emdash/api/content/{type}` | REST API |
| `wp_update_post()` | `PUT /_emdash/api/content/{type}/{id}` | REST API | | `wp_update_post()` | `PUT /_emdash/api/content/{type}/{id}` | REST API |
| `wp_delete_post()` | `DELETE /_emdash/api/content/{type}/{id}` | Soft delete | | `wp_delete_post()` | `DELETE /_emdash/api/content/{type}/{id}` | Soft delete |
| Custom tables | Plugin storage collections | `ctx.storage.collectionName.put/get/query` | | Custom tables | Plugin storage collections | `ctx.storage.collectionName.put/get/query` |
### Site Configuration ### Site Configuration
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ------------------------ | --------------------------- | ---------------------------------------- | | ------------------------ | --------------------------- | ---------------------------------------- |
| `get_bloginfo('name')` | `getSiteSetting('title')` | From `options` table with `site:` prefix | | `get_bloginfo('name')` | `getSiteSetting('title')` | From `options` table with `site:` prefix |
| `get_option('blogdesc')` | `getSiteSetting('tagline')` | Site settings API | | `get_option('blogdesc')` | `getSiteSetting('tagline')` | Site settings API |
| Theme Customizer | Site Settings admin page | `/_emdash/admin/settings` | | Theme Customizer | Site Settings admin page | `/_emdash/admin/settings` |
| `site_icon` | `getSiteSetting('favicon')` | Media reference | | `site_icon` | `getSiteSetting('favicon')` | Media reference |
| `custom_logo` | `getSiteSetting('logo')` | Media reference | | `custom_logo` | `getSiteSetting('logo')` | Media reference |
### Navigation Menus ### Navigation Menus
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ---------------------- | --------------------------------------- | ----------------------------------- | | ---------------------- | --------------------------------------- | ----------------------------------- |
| `register_nav_menu()` | Create menu via admin or seed | `_emdash_menus` table | | `register_nav_menu()` | Create menu via admin or seed | `_emdash_menus` table |
| `wp_nav_menu()` | `getMenu(name)` | Returns `{ items: MenuItem[] }` | | `wp_nav_menu()` | `getMenu(name)` | Returns `{ items: MenuItem[] }` |
| `wp_nav_menu_item` | `_emdash_menu_items` table | Type: custom, page, post, taxonomy | | `wp_nav_menu_item` | `_emdash_menu_items` table | Type: custom, page, post, taxonomy |
| `_menu_item_object_id` | `reference_id` + `reference_collection` | Links to content entries | | `_menu_item_object_id` | `reference_id` + `reference_collection` | Links to content entries |
| Menu locations | Query by name in templates | No locations concept — direct query | | Menu locations | Query by name in templates | No locations concept — direct query |
### Taxonomies ### Taxonomies
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| --------------------- | --------------------------------------- | ------------------------------ | | --------------------- | --------------------------------------- | ------------------------------ |
| `register_taxonomy()` | `_emdash_taxonomy_defs` table | Define via admin, seed, or API | | `register_taxonomy()` | `_emdash_taxonomy_defs` table | Define via admin, seed, or API |
| `get_terms()` | `getTaxonomyTerms(name)` | Returns tree for hierarchical | | `get_terms()` | `getTaxonomyTerms(name)` | Returns tree for hierarchical |
| `get_the_terms()` | `getEntryTerms(collection, id, name)` | Terms for specific entry | | `get_the_terms()` | `getEntryTerms(collection, id, name)` | Terms for specific entry |
| `wp_set_post_terms()` | `TaxonomyRepository.setTermsForEntry()` | Replace terms for entry | | `wp_set_post_terms()` | `TaxonomyRepository.setTermsForEntry()` | Replace terms for entry |
@@ -66,9 +66,9 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Widgets & Sidebars ### Widgets & Sidebars
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| -------------------- | -------------------------------------- | ------------------------------- | | -------------------- | -------------------------------------- | ------------------------------- |
| `register_sidebar()` | `_emdash_widget_areas` table | Create via admin or seed | | `register_sidebar()` | `_emdash_widget_areas` table | Create via admin or seed |
| `dynamic_sidebar()` | `getWidgetArea(name)` | Returns `{ widgets: Widget[] }` | | `dynamic_sidebar()` | `getWidgetArea(name)` | Returns `{ widgets: Widget[] }` |
| `WP_Widget` class | Widget types: content, menu, component | Simplified — 3 types only | | `WP_Widget` class | Widget types: content, menu, component | Simplified — 3 types only |
| Text widget | `type: 'content'` + Portable Text | Rich text widget | | Text widget | `type: 'content'` + Portable Text | Rich text widget |
@@ -77,7 +77,7 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Admin UI ### Admin UI
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ------------------------ | --------------------------------- | ---------------------------------------- | | ------------------------ | --------------------------------- | ---------------------------------------- |
| `add_menu_page()` | `admin.pages` in `definePlugin()` | Plugin config | | `add_menu_page()` | `admin.pages` in `definePlugin()` | Plugin config |
| `add_submenu_page()` | Nested admin pages | Parent determines hierarchy | | `add_submenu_page()` | Nested admin pages | Parent determines hierarchy |
@@ -88,7 +88,7 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Hooks ### Hooks
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ---------------------------------- | --------------------------------------- | ----------------------------------------------------- | | ---------------------------------- | --------------------------------------- | ----------------------------------------------------- |
| `add_action('init')` | `plugin:install` hook | Runs once on first install | | `add_action('init')` | `plugin:install` hook | Runs once on first install |
| `add_action('save_post')` | `content:afterSave` hook | Filter by `event.collection` | | `add_action('save_post')` | `content:afterSave` hook | Filter by `event.collection` |
@@ -100,7 +100,7 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Frontend Output ### Frontend Output
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ----------------------- | ---------------------------- | ---------------------------------------------------- | | ----------------------- | ---------------------------- | ---------------------------------------------------- |
| `add_shortcode()` | Portable Text custom block | Content → block. Template → component. Trusted only. | | `add_shortcode()` | Portable Text custom block | Content → block. Template → component. Trusted only. |
| `register_block_type()` | PT block + `componentsEntry` | Block data → Astro component props. Trusted only. | | `register_block_type()` | PT block + `componentsEntry` | Block data → Astro component props. Trusted only. |
@@ -109,7 +109,7 @@ This skill maps WordPress concepts to their EmDash equivalents for plugin portin
### Plugin Storage ### Plugin Storage
| WordPress | EmDash | Notes | | WordPress | EmDash | Notes |
| ------------------------ | ------------------------ | ---------------------------------- | | ------------------------ | ------------------------ | ---------------------------------- |
| `get_option('plugin_*')` | `ctx.kv.get(key)` | Namespaced to plugin automatically | | `get_option('plugin_*')` | `ctx.kv.get(key)` | Namespaced to plugin automatically |
| `update_option()` | `ctx.kv.set(key, value)` | Scoped KV storage | | `update_option()` | `ctx.kv.set(key, value)` | Scoped KV storage |

2
skills/wordpress-theme-to-emdash/phases/2-design.md
View File

@@ -37,7 +37,7 @@ theme.json # Block themes (WP 5.9+) - structured design tokens
### CSS Variable Mapping ### CSS Variable Mapping
| WP Pattern | EmDash Variable | | WP Pattern | EmDash Variable |
| ---------------- | ------------------ | | ---------------- | ------------------ |
| Body font family | `--font-body` | | Body font family | `--font-body` |
| Heading font | `--font-heading` | | Heading font | `--font-heading` |

16
skills/wordpress-theme-to-emdash/phases/4-dynamic.md
View File

@@ -7,13 +7,13 @@ Implement CMS-driven features: site settings, menus, taxonomies, and widgets.
Map WordPress customizer values to EmDash site settings: Map WordPress customizer values to EmDash site settings:
| WP Customizer Setting | EmDash Site Setting | | WP Customizer Setting | EmDash Site Setting |
| --------------------- | --------------------- | | --------------------- | ------------------- |
| Site Title | `title` | | Site Title | `title` |
| Tagline | `tagline` | | Tagline | `tagline` |
| Site Icon | `favicon` | | Site Icon | `favicon` |
| Custom Logo | `logo` | | Custom Logo | `logo` |
| Posts per page | `postsPerPage` | | Posts per page | `postsPerPage` |
| Date format | `dateFormat` | | Date format | `dateFormat` |
```astro ```astro
--- ---
@@ -134,7 +134,7 @@ const sidebar = await getWidgetArea("sidebar");
Map WP widgets to Astro components: Map WP widgets to Astro components:
| WP Widget | EmDash Component | | WP Widget | EmDash Component |
| ---------------- | ------------------- | | ---------------- | ------------------- |
| Recent Posts | `core:recent-posts` | | Recent Posts | `core:recent-posts` |
| Categories | `core:categories` | | Categories | `core:categories` |

16
skills/wordpress-theme-to-emdash/references/astro-essentials.md
View File

@@ -900,15 +900,15 @@ const { entry: page } = await getEmDashEntry("pages", "about");
### Key Differences ### Key Differences
| Aspect | Astro Collections | EmDash Collections | | Aspect | Astro Collections | EmDash Collections |
| ---------------------- | ------------------------------- | ----------------------------------------------- | | ---------------------- | ------------------------------- | ------------------------------------------- |
| **Config file** | `src/content.config.ts` | `src/live.config.ts` | | **Config file** | `src/content.config.ts` | `src/live.config.ts` |
| **Schema definition** | In config file with Zod | In EmDash admin UI or seed file | | **Schema definition** | In config file with Zod | In EmDash admin UI or seed file |
| **Data source** | Files, APIs, custom loaders | SQLite database | | **Data source** | Files, APIs, custom loaders | SQLite database |
| **Query functions** | `getCollection()`, `getEntry()` | `getEmDashCollection()`, `getEmDashEntry()` | | **Query functions** | `getCollection()`, `getEntry()` | `getEmDashCollection()`, `getEmDashEntry()` |
| **Content editing** | Edit source files directly | Admin UI or API | | **Content editing** | Edit source files directly | Admin UI or API |
| **Type safety** | Generated from schema | Runtime validation | | **Type safety** | Generated from schema | Runtime validation |
| **Rendering Markdown** | `render()` from `astro:content` | `<PortableText />` component | | **Rendering Markdown** | `render()` from `astro:content` | `<PortableText />` component |
### When to Use Which ### When to Use Which

32
skills/wordpress-theme-to-emdash/references/concept-mapping.md
View File

@@ -2,7 +2,7 @@
## Template Hierarchy ## Template Hierarchy
| WP Template | Purpose | EmDash Equivalent | | WP Template | Purpose | EmDash Equivalent |
| ------------------------- | ----------------------- | ------------------------------------------------------- | | ------------------------- | ----------------------- | ------------------------------------------------------- |
| `index.php` | Fallback for everything | `src/pages/index.astro` | | `index.php` | Fallback for everything | `src/pages/index.astro` |
| `front-page.php` | Static front page | `src/pages/index.astro` | | `front-page.php` | Static front page | `src/pages/index.astro` |
@@ -26,7 +26,7 @@
## Template Parts ## Template Parts
| WP Pattern | EmDash Pattern | | WP Pattern | EmDash Pattern |
| ---------------------------------------------------------- | ---------------------------- | | ---------------------------------------------------------- | ---------------------------- |
| `get_template_part('content', 'post')` | `<PostCard />` component | | `get_template_part('content', 'post')` | `<PostCard />` component |
| `get_template_part('template-parts/header/site-branding')` | `<SiteBranding />` component | | `get_template_part('template-parts/header/site-branding')` | `<SiteBranding />` component |
@@ -116,10 +116,10 @@ EmDash: Create collection via admin UI or API. The collection will be created du
### Content Retrieval ### Content Retrieval
| WP Function | EmDash Equivalent | | WP Function | EmDash Equivalent |
| ----------------------------- | ------------------------------------------------- | | ----------------------------- | ------------------------------------------------- |
| `have_posts()` / `the_post()` | `getEmDashCollection()` | | `have_posts()` / `the_post()` | `getEmDashCollection()` |
| `get_post()` | `getEmDashEntry()` | | `get_post()` | `getEmDashEntry()` |
| `the_title()` | `post.data.title` | | `the_title()` | `post.data.title` |
| `the_content()` | `<PortableText value={post.data.content} />` | | `the_content()` | `<PortableText value={post.data.content} />` |
| `the_excerpt()` | `post.data.excerpt` | | `the_excerpt()` | `post.data.excerpt` |
@@ -132,7 +132,7 @@ EmDash: Create collection via admin UI or API. The collection will be created du
### Taxonomies ### Taxonomies
| WP Function | EmDash Equivalent | | WP Function | EmDash Equivalent |
| ---------------------------- | -------------------------------------------------- | | ---------------------------- | -------------------------------------------------- |
| `get_categories()` | `getTaxonomyTerms("categories")` | | `get_categories()` | `getTaxonomyTerms("categories")` |
| `get_tags()` | `getTaxonomyTerms("tags")` | | `get_tags()` | `getTaxonomyTerms("tags")` |
@@ -149,7 +149,7 @@ EmDash supports hierarchical taxonomies (like categories) and flat taxonomies (l
### Site Info ### Site Info
| WP Function | EmDash Equivalent | | WP Function | EmDash Equivalent |
| ------------------------- | --------------------------------------- | | ------------------------- | --------------------------------------- |
| `bloginfo('name')` | `getSiteSetting("title")` | | `bloginfo('name')` | `getSiteSetting("title")` |
| `bloginfo('description')` | `getSiteSetting("tagline")` | | `bloginfo('description')` | `getSiteSetting("tagline")` |
@@ -173,7 +173,7 @@ EmDash supports hierarchical taxonomies (like categories) and flat taxonomies (l
### Media ### Media
| WP Function | EmDash Equivalent | | WP Function | EmDash Equivalent |
| --------------------------- | -------------------------- | | --------------------------- | -------------------------- |
| `wp_get_attachment_image()` | `<img src={media.url} />` | | `wp_get_attachment_image()` | `<img src={media.url} />` |
| `wp_get_attachment_url()` | `media.url` | | `wp_get_attachment_url()` | `media.url` |
@@ -181,7 +181,7 @@ EmDash supports hierarchical taxonomies (like categories) and flat taxonomies (l
### Navigation ### Navigation
| WP Function | EmDash Equivalent | | WP Function | EmDash Equivalent |
| ------------------------ | ------------------------------------- | | ------------------------ | ------------------------------------- |
| `wp_nav_menu()` | `getMenu("menu-name")` + render items | | `wp_nav_menu()` | `getMenu("menu-name")` + render items |
| `wp_list_pages()` | Query pages collection or use menu | | `wp_list_pages()` | Query pages collection or use menu |
@@ -198,10 +198,10 @@ WordPress hooks don't have direct equivalents. Most hook functionality becomes:
3. **Build-time logic** - In Astro config or components 3. **Build-time logic** - In Astro config or components
| WP Hook | EmDash Approach | | WP Hook | EmDash Approach |
| -------------------- | ------------------------------------------ | | -------------------- | ---------------------------------------- |
| `wp_head` | Add to `<head>` in layout | | `wp_head` | Add to `<head>` in layout |
| `wp_footer` | Add before `</body>` in layout | | `wp_footer` | Add before `</body>` in layout |
| `the_content` filter | PortableText components | | `the_content` filter | PortableText components |
| `pre_get_posts` | Query filters in `getEmDashCollection()` | | `pre_get_posts` | Query filters in `getEmDashCollection()` |
| `save_post` | EmDash plugin hook: `content:beforeSave` | | `save_post` | EmDash plugin hook: `content:beforeSave` |
@@ -280,14 +280,14 @@ sidebar?.widgets.forEach((widget) => {
### Widget Types ### Widget Types
| WP Widget | EmDash Widget Type | Notes | | WP Widget | EmDash Widget Type | Notes |
| ------------ | ------------------------------- | ----------------------------- | | ------------ | ------------------------------- | ----------------------------- |
| Text/HTML | `content` | Portable Text (rich content) | | Text/HTML | `content` | Portable Text (rich content) |
| Custom Menu | `menu` | References menu by name | | Custom Menu | `menu` | References menu by name |
| Recent Posts | `component` `core:recent-posts` | Built-in component with props | | Recent Posts | `component` `core:recent-posts` | Built-in component with props |
| Categories | `component` `core:categories` | Built-in component | | Categories | `component` `core:categories` | Built-in component |
| Tag Cloud | `component` `core:tag-cloud` | Built-in component | | Tag Cloud | `component` `core:tag-cloud` | Built-in component |
| Search | `<LiveSearch />` component | Use `emdash/ui` LiveSearch | | Search | `<LiveSearch />` component | Use `emdash/ui` LiveSearch |
| Archives | `component` `core:archives` | Built-in component | | Archives | `component` `core:archives` | Built-in component |
### Core Widget Components ### Core Widget Components
@@ -358,7 +358,7 @@ const results = query ? await search(query, { limit: 20 }) : { results: [] };
### Search Features ### Search Features
| WordPress | EmDash | | WordPress | EmDash |
| ---------------------------- | ------------------------------- | | ---------------------------- | ------------------------------- |
| Basic keyword search | FTS5 with Porter stemming | | Basic keyword search | FTS5 with Porter stemming |
| Search all public post types | Per-collection search enable | | Search all public post types | Per-collection search enable |

2
skills/wordpress-theme-to-emdash/references/design-extraction.md
View File

@@ -104,7 +104,7 @@ Common elements to check:
### Common Color Mapping ### Common Color Mapping
| WP Pattern | EmDash Variable | | WP Pattern | EmDash Variable |
| ---------------- | ------------------- | | ---------------- | ------------------- |
| Background | `--color-base` | | Background | `--color-base` |
| Text | `--color-contrast` | | Text | `--color-contrast` |

20
templates/blank/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/blank/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/blank/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

10
templates/blank/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

20
templates/blog-cloudflare/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/blog-cloudflare/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/blog-cloudflare/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

10
templates/blog-cloudflare/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

4
templates/blog-cloudflare/wrangler.jsonc
View File

@@ -2,9 +2,7 @@
"$schema": "node_modules/wrangler/config-schema.json", "$schema": "node_modules/wrangler/config-schema.json",
"name": "my-emdash-site", "name": "my-emdash-site",
"compatibility_date": "2026-02-24", "compatibility_date": "2026-02-24",
"compatibility_flags": [ "compatibility_flags": ["nodejs_compat"],
"nodejs_compat"
],
"assets": { "assets": {
"directory": "./dist", "directory": "./dist",
}, },

20
templates/blog/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/blog/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/blog/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

10
templates/blog/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

20
templates/marketing-cloudflare/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/marketing-cloudflare/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/marketing-cloudflare/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

20
templates/marketing/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/marketing/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/marketing/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

20
templates/portfolio-cloudflare/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/portfolio-cloudflare/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/portfolio-cloudflare/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

20
templates/portfolio/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/portfolio/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/portfolio/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

20
templates/starter-cloudflare/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/starter-cloudflare/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/starter-cloudflare/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

10
templates/starter-cloudflare/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }

4
templates/starter-cloudflare/wrangler.jsonc
View File

@@ -2,9 +2,7 @@
"$schema": "node_modules/wrangler/config-schema.json", "$schema": "node_modules/wrangler/config-schema.json",
"name": "my-emdash-site", "name": "my-emdash-site",
"compatibility_date": "2026-02-24", "compatibility_date": "2026-02-24",
"compatibility_flags": [ "compatibility_flags": ["nodejs_compat"],
"nodejs_compat"
],
"assets": { "assets": {
"directory": "./dist", "directory": "./dist",
}, },

20
templates/starter/.agents/skills/creating-plugins/SKILL.md
View File

@@ -261,17 +261,17 @@ The `"."` export has the descriptor. The `"./sandbox"` export has the implementa
Each feature is optional. Add only what your plugin needs: Each feature is optional. Add only what your plugin needs:
| Feature | Where | Standard | Native | Purpose | | Feature | Where | Standard | Native | Purpose |
| ------------------- | ---------------------------- | -------- | ------ | ------------------------------------------------------- | | ------------------- | ---------------------------- | -------- | ------ | ----------------------------------------------------- |
| **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events | | **Hooks** | `definePlugin({ hooks })` | Yes | Yes | React to content/media/lifecycle events |
| **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries | | **Storage** | descriptor `storage` | Yes | Yes | Document collections with indexed queries |
| **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state | | **KV** | `ctx.kv` in hooks/routes | Yes | Yes | Key-value store for internal state |
| **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` | | **API Routes** | `definePlugin({ routes })` | Yes | Yes | REST endpoints at `/_emdash/api/plugins/<id>/<route>` |
| **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) | | **Admin Pages** | Block Kit `admin` route | Yes | Yes | Admin pages via Block Kit (JSON blocks) |
| **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit | | **Widgets** | Block Kit `admin` route | Yes | Yes | Dashboard cards via Block Kit |
| **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) | | **React Admin** | `admin.entry` + React export | No | Yes | React-based admin pages and widgets (native only) |
| **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor | | **PT Blocks** | `admin.portableTextBlocks` | No | Yes | Custom block types in the Portable Text editor |
| **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site | | **Site Components** | `componentsEntry` | No | Yes | Astro components for rendering blocks on the site |
See the reference files for detailed syntax: See the reference files for detailed syntax:

4
templates/starter/.agents/skills/creating-plugins/references/api-routes.md
View File

@@ -66,8 +66,8 @@ definePlugin({
## Route URLs ## Route URLs
| Plugin ID | Route Name | URL | | Plugin ID | Route Name | URL |
| --------- | --------------- | ------------------------------------------ | | --------- | --------------- | ---------------------------------------- |
| `forms` | `status` | `/_emdash/api/plugins/forms/status` | | `forms` | `status` | `/_emdash/api/plugins/forms/status` |
| `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` | | `forms` | `submissions` | `/_emdash/api/plugins/forms/submissions` |
| `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` | | `seo` | `settings/save` | `/_emdash/api/plugins/seo/settings/save` |

8
templates/starter/AGENTS.md
View File

@@ -14,11 +14,11 @@ The admin UI is at `http://localhost:4321/_emdash/admin`.
| File | Purpose | | File | Purpose |
| ------------------------ | ---------------------------------------------------------------------------------- | | ------------------------ | ---------------------------------------------------------------------------------- |
| `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage | | `astro.config.mjs` | Astro config with `emdash()` integration, database, and storage |
| `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) | | `src/live.config.ts` | EmDash loader registration (boilerplate -- don't modify) |
| `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) | | `seed/seed.json` | Schema definition + demo content (collections, fields, taxonomies, menus, widgets) |
| `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) | | `emdash-env.d.ts` | Generated types for collections (auto-regenerated on dev server start) |
| `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) | | `src/layouts/Base.astro` | Base layout with EmDash wiring (menus, search, page contributions) |
| `src/pages/` | Astro pages -- all server-rendered | | `src/pages/` | Astro pages -- all server-rendered |
## Skills ## Skills

10
templates/starter/tsconfig.json
View File

@@ -1,13 +1,7 @@
{ {
"extends": "astro/tsconfigs/base", "extends": "astro/tsconfigs/base",
"compilerOptions": { "compilerOptions": {
"types": [ "types": ["node"]
"node"
]
}, },
"include": [ "include": ["src", ".astro/types.d.ts", "emdash-env.d.ts"]
"src",
".astro/types.d.ts",
"emdash-env.d.ts"
]
} }