{
"schemaVersion": "1.0",
"item": {
"slug": "fastmode",
"name": "FastMode CMS - Host, Deploy, Manage Websites for Free",
"source": "tencent",
"type": "skill",
"category": "其他",
"sourceUrl": "https://clawhub.ai/arihgoldstein/fastmode",
"canonicalUrl": "https://clawhub.ai/arihgoldstein/fastmode",
"targetPlatform": "OpenClaw"
},
"install": {
"downloadMode": "redirect",
"downloadUrl": "/downloads/fastmode",
"sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastmode",
"sourcePlatform": "tencent",
"targetPlatform": "OpenClaw",
"installMethod": "Manual import",
"extraction": "Extract archive",
"prerequisites": [
"OpenClaw"
],
"packageFormat": "ZIP package",
"includedAssets": [
"SKILL.md"
],
"primaryDoc": "SKILL.md",
"quickSetup": [
"Download the package from Yavira.",
"Extract the archive and review SKILL.md first.",
"Import or place the package into your OpenClaw setup."
],
"agentAssist": {
"summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
"steps": [
"Download the package from Yavira.",
"Extract it into a folder your agent can access.",
"Paste one of the prompts below and point your agent at the extracted folder."
],
"prompts": [
{
"label": "New install",
"body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
},
{
"label": "Upgrade existing",
"body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
}
]
},
"sourceHealth": {
"source": "tencent",
"slug": "fastmode",
"status": "healthy",
"reason": "direct_download_ok",
"recommendedAction": "download",
"checkedAt": "2026-04-29T05:55:27.603Z",
"expiresAt": "2026-05-06T05:55:27.603Z",
"httpStatus": 200,
"finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastmode",
"contentType": "application/zip",
"probeMethod": "head",
"details": {
"probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastmode",
"contentDisposition": "attachment; filename=\"fastmode-1.5.3.zip\"",
"redirectLocation": null,
"bodySnippet": null,
"slug": "fastmode"
},
"scope": "item",
"summary": "Item download looks usable.",
"detail": "Yavira can redirect you to the upstream package for this item.",
"primaryActionLabel": "Download for OpenClaw",
"primaryActionHref": "/downloads/fastmode"
},
"validation": {
"installChecklist": [
"Use the Yavira download entry.",
"Review SKILL.md after the package is downloaded.",
"Confirm the extracted package contains the expected setup assets."
],
"postInstallChecks": [
"Confirm the extracted package includes the expected docs or setup files.",
"Validate the skill or prompts are available in your target agent workspace.",
"Capture any manual follow-up steps the agent could not complete."
]
},
"downloadPageUrl": "https://openagent3.xyz/downloads/fastmode",
"agentPageUrl": "https://openagent3.xyz/skills/fastmode/agent",
"manifestUrl": "https://openagent3.xyz/skills/fastmode/agent.json",
"briefUrl": "https://openagent3.xyz/skills/fastmode/agent.md"
},
"agentAssist": {
"summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
"steps": [
"Download the package from Yavira.",
"Extract it into a folder your agent can access.",
"Paste one of the prompts below and point your agent at the extracted folder."
],
"prompts": [
{
"label": "New install",
"body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
},
{
"label": "Upgrade existing",
"body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
}
]
},
"documentation": {
"source": "clawhub",
"primaryDoc": "SKILL.md",
"sections": [
{
"title": "FastMode CLI — Complete Agent Reference",
"body": "FastMode lets you create a live website, deploy it to the cloud, and manage all its content — entirely from the command line. One-time browser login for OAuth authentication, then every operation runs in the terminal. No local servers, no manual dashboards.\n\nFree cloud hosting — every site gets a live URL at yoursite.fastmode.ai\nFree SSL — HTTPS included automatically\nCustom domains — connect any domain (e.g. www.example.com)\nFull CMS — any content structure (blog, team, products, portfolios, anything)\nAgent-native — every operation works via CLI, zero human intervention needed"
},
{
"title": "Table of Contents",
"body": "End-to-End Workflow\nCRITICAL: Before You Build Anything\nWebsite Analysis\nCommand Reference\nProject Resolution\nSchema & Field Types\nContent Items\nClient Portal Management\nPackage Structure\nManifest Format\nTemplate Syntax (includes SEO rules, image handling, forms, inline editing)\nDeployment & Build Status\nValidation\nCommon Mistakes & How to Fix Them\nPre-Deployment Checklist\nError Handling & Exit Codes"
},
{
"title": "End-to-End Workflow",
"body": "This is the complete sequence to go from nothing to a live website.\n\n# 1. Authenticate (one-time — credentials persist at ~/.fastmode/credentials.json)\nfastmode login\n\n# 2. Create a project (gets a free hosted URL instantly)\nfastmode projects create \"Acme Corp\"\nfastmode use \"Acme Corp\"\n\n# 3. Define content structure (write schema.json, then sync it)\nfastmode schema sync -f schema.json\n\n# 4. Add content\nfastmode items create posts -n \"Welcome\" -d '{\"title\": \"Welcome to Acme\", \"body\": \"
\"}'\n\n# 5. Build HTML templates with {{tokens}}, package into a zip, validate, deploy\nfastmode validate package site.zip\nfastmode deploy site.zip\n# Deploy waits for build to finish and reports success or failure with error details\n\n# 6. If the build failed, check what went wrong\nfastmode status\n# Fix the issue, then re-deploy"
},
{
"title": "CRITICAL: Before You Build Anything",
"body": "STOP. Before writing ANY HTML, templates, or manifest.json, complete these steps."
},
{
"title": "Step 1: Check for Existing Projects",
"body": "fastmode projects\n\nThis lists all the user's existing FastMode projects."
},
{
"title": "Step 2: Decide — Existing or New Project",
"body": "If projects exist: Ask the user: \"Is this website for one of your existing projects, or should I create a new one?\" Let the user choose.\n\nIf NO projects exist: This is a new user — ask: \"What would you like to name your new project?\""
},
{
"title": "Step 3a: For EXISTING Projects",
"body": "User selects the project from the list\nRun fastmode use \"Project Name\" to set it as default\nRun fastmode schema show to get the current collections and fields\nUse this schema to build templates with the correct field names"
},
{
"title": "Step 3b: For NEW Projects",
"body": "Ask for the project name if you don't have it\nRun fastmode projects create \"Project Name\"\nRun fastmode use \"Project Name\"\nYou'll create the schema later with fastmode schema sync\nOptionally generate sample content: fastmode generate-samples"
},
{
"title": "Checkpoint — Confirm Before Continuing",
"body": "RequirementHow to Get ItProject selected/createdfastmode projects / fastmode projects createDefault setfastmode use \"Project Name\"Schema known (existing)fastmode schema show\n\nIf you don't have a project set, DO NOT PROCEED. Go back to Step 1.\n\nWHY THIS MATTERS:\n\nFor existing projects: The schema determines which fields to use in templates — get it wrong and the build fails\nFor new projects: You need the project before you can deploy\nAlways: The user must confirm which project to use — never assume"
},
{
"title": "Website Analysis (Do This Before Writing Code)",
"body": "Before writing any HTML or templates, analyze the site:\n\nMap ALL URLs — document every page path (/, /about, /blog, /blog/post-slug, etc.)\nCategorize each page — Static (fixed content), List (shows multiple items), or Detail (single item from a collection)\nIdentify collections — repeating content that should be CMS-managed (blog posts, team members, products, testimonials, etc.)\nDocument assets — all CSS, JS, image, and font file locations\nPRESERVE original URLs — if the site uses /resources for articles, keep /resources. Do NOT change it to /blog. Use the manifest's path configuration."
},
{
"title": "Authentication",
"body": "fastmode login # Open browser for OAuth device flow\nfastmode logout # Delete ~/.fastmode/credentials.json\nfastmode whoami # Show current user email and name\n\nlogin uses OAuth 2.0 device authorization flow: opens a browser window where the user approves access on fastmode.ai, then credentials are saved automatically. The browser is only needed for this one-time login step.\nOAuth scopes: The token grants access to the user's FastMode projects only (project management, schema editing, content CRUD, deployments). No third-party service access is requested.\nCredentials persist at ~/.fastmode/credentials.json with restricted file permissions (0o600 — owner read/write only). Treat this file as a sensitive secret.\nTokens auto-refresh. If a token expires, the next command will refresh it silently using the stored refresh token.\nIf credentials are missing or invalid, most commands will trigger the login flow automatically.\nlogout deletes ~/.fastmode/credentials.json and revokes the stored tokens."
},
{
"title": "Projects",
"body": "fastmode projects # List all projects (default action)\nfastmode projects list # Same as above\nfastmode projects create \"Name\" # Create a new project\nfastmode projects create \"Name\" --subdomain custom-sub # Custom subdomain\nfastmode projects create \"Name\" --force # Skip similar-name check\nfastmode use # Set default project for all commands\n\nprojects create checks for existing projects with similar names. Use --force to skip.\nSubdomain auto-generated from name if not provided (lowercase, hyphens, max 30 chars).\nuse stores the default in ~/.fastmode/config.json. Does NOT validate the project exists."
},
{
"title": "Schema",
"body": "fastmode schema show # Show all collections and fields\nfastmode schema show -p \"Project Name\" # Specify project\nfastmode schema sync -f schema.json # Create collections and fields from JSON file\nfastmode schema field-types # List all available field types (no auth needed)\n\nschema show requires authentication and a project.\nschema sync reads a local JSON file and creates/updates the schema. Skips duplicates. Two-phase: creates collections first, then fields (handles relation dependencies).\nschema field-types works without authentication."
},
{
"title": "Content Items",
"body": "fastmode items list # List all items\nfastmode items list posts --limit 10 --sort publishedAt --order desc\nfastmode items get # Get single item\nfastmode items create -n \"Name\" -d '{\"field\": \"value\"}'\nfastmode items create posts -n \"Title\" -f data.json # Data from file\nfastmode items create posts -n \"Draft Post\" -d '{}' --draft\nfastmode items update -d '{\"field\": \"new value\"}'\nfastmode items update posts my-post -n \"New Title\"\nfastmode items update posts my-post --publish # Publish a draft\nfastmode items update posts my-post --unpublish # Revert to draft\nfastmode items delete --confirm # REQUIRES --confirm\nfastmode items relations # Show linkable items for relation fields\nfastmode items relations posts --field author # Options for specific field\n\nSee the Content Items section below for detailed rules on data formats, relation fields, and drafts."
},
{
"title": "Client Portal Management",
"body": "fastmode clients list # List portal clients with access\nfastmode clients invite client@example.com # Invite with default permissions\nfastmode clients invite client@example.com -n \"Jane\" --permissions cms.read,cms.write\nfastmode clients invitations # List pending invitations\nfastmode clients update-permissions --permissions cms.read,editor\nfastmode clients revoke --confirm # REQUIRES --confirm\nfastmode clients cancel-invite --confirm # REQUIRES --confirm\n\nSee the Client Portal Management section below for details on permissions, invite flow, and examples."
},
{
"title": "Deployment & Build Status",
"body": "fastmode deploy site.zip # Deploy and wait for build to finish\nfastmode deploy site.zip --force # Skip GitHub sync check\nfastmode deploy site.zip --no-wait # Upload only, don't wait for build\nfastmode deploy site.zip --timeout 300000 # Custom timeout in ms (default: 120000)\nfastmode status # Check current build/deploy status\nfastmode deploys # List deployment history\nfastmode deploys --limit 5 # Limit number of results\n\nSee Deployment & Build Status below for the full deploy lifecycle."
},
{
"title": "Validation",
"body": "fastmode validate manifest manifest.json\nfastmode validate template index.html -t custom_index\nfastmode validate template post.html -t custom_detail -c posts\nfastmode validate template post.html -t custom_detail -c posts -p \"My Project\"\nfastmode validate template about.html -t static_page\nfastmode validate package site.zip\n\nTemplate types: custom_index (collection listing), custom_detail (single item), static_page (fixed page).\n-c specifies the collection slug (required for custom_index and custom_detail).\n-p validates tokens against the actual project schema (reports missing fields).\nAll validation commands exit with code 1 on errors — safe for CI/CD pipelines."
},
{
"title": "Documentation & Examples",
"body": "fastmode examples # Code examples for a specific pattern\nfastmode guide # Full website conversion guide\nfastmode guide templates # Template syntax guide\nfastmode guide common_mistakes # Common pitfalls to avoid\nfastmode generate-samples # Generate placeholder content for empty collections\nfastmode generate-samples -c posts team # Specific collections only\n\nAvailable example types: manifest_basic, manifest_custom_paths, blog_index_template, blog_post_template, team_template, downloads_template, form_handling, asset_paths, data_edit_keys, each_loop, conditional_if, nested_fields, featured_posts, parent_context, equality_comparison, comparison_helpers, youtube_embed, nested_collection_loop, loop_variables, common_mistakes.\n\nAvailable guide sections: full, first_steps, analysis, structure, seo, manifest, templates, tokens, forms, assets, checklist, common_mistakes."
},
{
"title": "Project Resolution",
"body": "Every project-scoped command (schema, items, deploy, status, etc.) needs a project. Resolution order:\n\n-p / --project flag — explicit on the command: -p \"My Project\" or -p abc123-uuid\nFASTMODE_PROJECT environment variable — set in shell: export FASTMODE_PROJECT=\"My Project\"\nDefault project — saved by fastmode use \"My Project\" in ~/.fastmode/config.json\n\nIf none is set, the command prints an error and exits with code 1:\n\nError: No project specified.\nUse -p , set FASTMODE_PROJECT env var, or run: fastmode use \n\nProject identifiers can be:\n\nUUID — used directly (e.g. 550e8400-e29b-41d4-a716-446655440000)\nProject name — resolved via API (exact match first, then partial match, case-insensitive)"
},
{
"title": "Creating a Schema",
"body": "Write a schema.json file and sync it:\n\nfastmode schema sync -f schema.json"
},
{
"title": "schema.json Format",
"body": "{\n \"collections\": [\n {\n \"slug\": \"posts\",\n \"name\": \"Blog Posts\",\n \"nameSingular\": \"Blog Post\",\n \"fields\": [\n { \"slug\": \"title\", \"name\": \"Title\", \"type\": \"text\", \"isRequired\": true },\n { \"slug\": \"excerpt\", \"name\": \"Excerpt\", \"type\": \"textarea\" },\n { \"slug\": \"body\", \"name\": \"Body\", \"type\": \"richText\" },\n { \"slug\": \"featured-image\", \"name\": \"Featured Image\", \"type\": \"image\" },\n { \"slug\": \"category\", \"name\": \"Category\", \"type\": \"select\", \"options\": \"News, Tutorial, Update\" },\n { \"slug\": \"tags\", \"name\": \"Tags\", \"type\": \"multiSelect\", \"options\": \"JavaScript, Python, DevOps, AI\" },\n { \"slug\": \"featured\", \"name\": \"Featured\", \"type\": \"boolean\" },\n { \"slug\": \"author\", \"name\": \"Author\", \"type\": \"relation\", \"referenceCollection\": \"team\" }\n ]\n },\n {\n \"slug\": \"team\",\n \"name\": \"Team Members\",\n \"nameSingular\": \"Team Member\",\n \"fields\": [\n { \"slug\": \"role\", \"name\": \"Role\", \"type\": \"text\" },\n { \"slug\": \"bio\", \"name\": \"Bio\", \"type\": \"richText\" },\n { \"slug\": \"photo\", \"name\": \"Photo\", \"type\": \"image\" },\n { \"slug\": \"email\", \"name\": \"Email\", \"type\": \"email\" }\n ]\n }\n ]\n}\n\nTo add fields to existing collections, use fieldsToAdd:\n\n{\n \"fieldsToAdd\": [\n {\n \"collectionSlug\": \"posts\",\n \"fields\": [\n { \"slug\": \"reading-time\", \"name\": \"Reading Time\", \"type\": \"number\" }\n ]\n }\n ]\n}\n\nYou can combine collections and fieldsToAdd in the same file. Duplicate collections and fields are automatically skipped."
},
{
"title": "Available Field Types",
"body": "TypeDescriptionTemplate UsageNotestextSingle-line text{{field}}Titles, names, short stringstextareaMulti-line plain text{{field}}Descriptions, excerptsrichTextFormatted HTML content{{{field}}}MUST use triple bracesnumberNumeric value{{field}}Prices, counts, orderbooleanTrue/false toggle{{#if field}}Toggles, flagsdateDate only{{field}}Birth dates, event datesdatetimeDate and time{{field}}TimestampsimageImage file/URL{{field}}Renders as URLfileDownloadable file (max 10MB){{field}}Link as urlWeb link{{field}}External URLsvideoEmbedYouTube/Vimeo/Wistia/Loom{{field}}Embed URLemailEmail with validation{{field}}Validated email addressesselectSingle dropdown{{field}}Requires \"options\": \"A, B, C\"multiSelectMultiple selections{{field}}Requires \"options\": \"A, B, C\"relationLink to another collection{{field.name}}Requires \"referenceCollection\": \"slug\""
},
{
"title": "Relation Fields — CRITICAL",
"body": "Relation fields link items between collections (e.g. a post has an author from the team collection). When creating or updating items with relation fields:\n\nYou MUST use the item's UUID, not its name or slug\nUse fastmode items relations to get the available IDs\nExample: fastmode items relations posts --field author shows team member IDs\n\n# First, find the author's item ID\nfastmode items relations posts --field author\n# Output shows: ID: 550e8400-..., Name: Jane Doe, Slug: jane-doe\n\n# Then use that ID when creating a post\nfastmode items create posts -n \"My Post\" -d '{\"title\": \"My Post\", \"author\": \"550e8400-e29b-41d4-a716-446655440000\"}'\n\nWRONG: \"author\": \"Jane Doe\" — this will NOT work.\nCORRECT: \"author\": \"550e8400-e29b-41d4-a716-446655440000\" — use the UUID."
},
{
"title": "Creating Items",
"body": "fastmode items create -n \"Item Name\" -d '{\"field\": \"value\"}'\n\nFlagDescription-n, --name Required. Item name/title.-s, --slug URL slug. Auto-generated from name if omitted.-d, --data Field data as JSON string.-f, --file Read field data from a JSON file (takes precedence over -d).-p, --project Project ID or name.--draftCreate as unpublished draft.\n\nData rules:\n\n-d value must be valid JSON. Keys are field slugs.\n-f reads from a JSON file. If both -f and -d are given, -f wins.\nIf neither -d nor -f is given, the item is created with just the name (no field data).\nRich text fields accept raw HTML: \"body\": \"
\n\nCategory: {{category}}\nVisit"
},
{
"title": "Rich Text Fields — Triple Braces {{{field}}}",
"body": "CRITICAL: Rich text fields contain HTML. You MUST use triple braces {{{ }}} so the HTML renders correctly. Double braces will escape the HTML and display raw tags as text.\n\n\n
{{{body}}}
\n
{{{bio}}}
\n\n\n
{{body}}
"
},
{
"title": "Loops — {{#each collection}}",
"body": "Used in index templates and static pages to iterate over collection items.\n\nBasic loop:\n\n{{#each posts}}\n \n
\n \n{{/each}}\n\nLoop modifiers:\n\nModifierDescriptionExamplelimit=NMaximum items{{#each posts limit=6}}sort=\"field\"Sort by field{{#each posts sort=\"publishedAt\"}}order=\"asc|desc\"Sort direction{{#each posts sort=\"name\" order=\"asc\"}}featured=trueOnly featured items{{#each posts featured=true limit=3}}where=\"field.slug:{{slug}}\"Filter by relation{{#each posts where=\"author.slug:{{slug}}\"}}\n\nCombined modifiers:\n\n\n{{#each posts featured=true limit=3 sort=\"publishedAt\" order=\"desc\"}}\n {{name}}\n{{/each}}"
},
{
"title": "Loop Variables",
"body": "Available only inside {{#each}} blocks:\n\nVariableDescriptionExample{{@index}}Zero-based index (0, 1, 2...)Item {{@index}}{{@first}}True for the first item{{#if @first}}hero{{/if}}{{@last}}True for the last item{{#unless @last}},{{/unless}}{{@length}}Total number of itemsShowing {{@length}} items\n\nDo NOT use loop variables outside {{#each}} blocks — they will produce warnings and undefined values.\n\n{{#each posts}}\n {{#if @first}}\n
\n \n {{/if}}\n{{/each}}"
},
{
"title": "Nested Loops with @root.",
"body": "When nesting loops, use @root. to reference root-level collections:\n\n{{#each categories}}\n
{{name}}
\n {{#each @root.posts where=\"category.slug:{{slug}}\"}}\n {{name}}\n {{/each}}\n{{/each}}"
},
{
"title": "Inline Editing — data-edit-key (CRITICAL for Static Pages)",
"body": "Without data-edit-key attributes, static pages have NO editable content in the CMS dashboard. Every text element that should be editable MUST have one.\n\n\n
Welcome to Our Site
\n
We build amazing things.
\n
Our story began in 2020...
\n\n\n\n
About Us
\n
First paragraph...
\n
Second paragraph...
\n\n\n\n
Our Blog
\n\nNaming convention: {page}-{section}-{element}\n\nExamples: home-hero-title, about-team-heading, contact-form-intro, services-cta-button\n\nRules:\n\nKeys must be unique across the entire site (not just the page).\nUse lowercase with hyphens.\nFor different pages, prefix with the page name.\nStatic pages without edit keys will appear in the CMS but have nothing editable."
},
{
"title": "Video Embeds",
"body": "{{#if video}}\n \n{{/if}}\n\nThe referrerpolicy=\"strict-origin-when-cross-origin\" attribute is required for YouTube embeds — without it, videos may show Error 150/153."
},
{
"title": "Images — Static vs CMS Content",
"body": "There are two types of images and they are handled differently:\n\n1. Static/UI images — logos, icons, decorative backgrounds bundled with the site:\n\n\n\n\n\n2. CMS content images — post images, team photos, product images managed through the CMS:\n\n\n{{#if image}}\n \n{{/if}}\n\nRule of thumb: If it's site branding/design → keep static. If it's content that changes per item → use CMS tokens.\n\nAlways wrap CMS images in {{#if}} — not every item may have an image:\n\n{{#if image}}\n \n{{else}}\n \n{{/if}}\n\nCommon mistake — mixing static and CMS images:\n\n\n{{#each products}}\n \n
\n{{/each}}"
},
{
"title": "Forms",
"body": "\n\nRules:\n\ndata-form-name attribute is required.\naction must point to /_forms/{formName}.\nAll inputs must have name attributes.\nA submit button is required.\n\nCRITICAL: Remove Original Form Handlers\n\nIf the source site has JavaScript that handles form submissions, you MUST remove or replace it. Original site JS often does e.preventDefault() and shows a \"fake\" success toast — the data goes nowhere.\n\n// PROBLEM: This blocks real submissions!\nform.addEventListener('submit', (e) => {\n e.preventDefault();\n showToast('Message sent!'); // FAKE! Data not saved!\n});\n\nOption A (simplest): Remove the original JavaScript form handler entirely. The native
![\"Logo\"](\"/public/images/logo.png\"){kind=logo}
\n\nThis also applies inside CSS files — background images AND fonts:\n\n/* WRONG */\nbackground-image: url('../images/bg.jpg');\nbackground-image: url('images/bg.jpg');\nsrc: url('../fonts/custom.woff2');\n\n/* CORRECT */\nbackground-image: url('/public/images/bg.jpg');\nsrc: url('/public/fonts/custom.woff2');\n\nAsset path conversion table:\n\nOriginal PathConverted Pathcss/style.css/public/css/style.css../css/style.css/public/css/style.css./images/logo.png/public/images/logo.png/images/logo.png/public/images/logo.png../fonts/custom.woff/public/fonts/custom.woff\n\nExternal URLs (Google Fonts, CDNs, etc.) stay unchanged."
},
{
"title": "Manifest Format",
"body": "The manifest.json file defines the site structure. It uses a FLAT format for CMS templates (not nested)."
},
{
"title": "Basic Example (Static Only)",
"body": "{\n \"pages\": [\n { \"path\": \"/\", \"file\": \"pages/index.html\", \"title\": \"Home\" },\n { \"path\": \"/about\", \"file\": \"pages/about.html\", \"title\": \"About\" },\n { \"path\": \"/contact\", \"file\": \"pages/contact.html\", \"title\": \"Contact\" }\n ]\n}"
},
{
"title": "With CMS Collections",
"body": "{\n \"pages\": [\n { \"path\": \"/\", \"file\": \"pages/index.html\", \"title\": \"Home\" },\n { \"path\": \"/about\", \"file\": \"pages/about.html\", \"title\": \"About\" }\n ],\n \"cmsTemplates\": {\n \"postsIndex\": \"templates/posts_index.html\",\n \"postsIndexPath\": \"/blog\",\n \"postsDetail\": \"templates/posts_detail.html\",\n \"postsDetailPath\": \"/blog\",\n \"teamIndex\": \"templates/team_index.html\",\n \"teamIndexPath\": \"/team\"\n }\n}"
},
{
"title": "CMS Template Keys — FLAT Format",
"body": "Each collection needs 2-4 keys in cmsTemplates. The format is {collectionSlug}Index, {collectionSlug}IndexPath, {collectionSlug}Detail, {collectionSlug}DetailPath.\n\nKeyRequiredDescription{slug}IndexYesPath to the collection listing template file{slug}IndexPathYesURL path for the listing page (e.g. /blog){slug}DetailNoPath to the single item template file{slug}DetailPathNoURL path prefix for item pages (e.g. /blog → /blog/item-slug)\n\nExample for a \"services\" collection:\n\n\"cmsTemplates\": {\n \"servicesIndex\": \"templates/services_index.html\",\n \"servicesIndexPath\": \"/services\",\n \"servicesDetail\": \"templates/services_detail.html\",\n \"servicesDetailPath\": \"/services\"\n}"
},
{
"title": "Common Manifest Mistakes — AI Agents Frequently Get This Wrong",
"body": "AI agents frequently use a nested object format or \"collections\" key that FastMode does NOT support. Read carefully.\n\nWRONG — using \"collections\" key (MOST COMMON AI MISTAKE):\n\n{\n \"collections\": {\n \"posts\": {\n \"indexPath\": \"/blog\",\n \"indexFile\": \"collections/posts/index.html\",\n \"detailPath\": \"/blog/:slug\",\n \"detailFile\": \"collections/posts/detail.html\"\n }\n }\n}\n\nWRONG — nested objects inside cmsTemplates:\n\n\"cmsTemplates\": {\n \"posts\": {\n \"indexPath\": \"/blog\",\n \"detailPath\": \"/blog\"\n }\n}\n\nWRONG — singular slug names:\n\n\"postIndex\": \"...\" // Should be \"postsIndex\"\n\"postDetail\": \"...\" // Should be \"postsDetail\"\n\nCORRECT — flat keys using cmsTemplates, matching the collection slug exactly:\n\n\"cmsTemplates\": {\n \"postsIndex\": \"templates/posts_index.html\",\n \"postsIndexPath\": \"/blog\",\n \"postsDetail\": \"templates/posts_detail.html\",\n \"postsDetailPath\": \"/blog\"\n}\n\nKey rules:\n\nUse cmsTemplates, NOT collections\nUse FLAT keys: {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath\nDo NOT nest objects inside collection names\nUse fastmode validate manifest manifest.json to catch these errors before deploying"
},
{
"title": "Optional: Head/Body Injection",
"body": "{\n \"pages\": [...],\n \"cmsTemplates\": {...},\n \"defaultHeadHtml\": \"\",\n \"defaultBodyEndHtml\": \"\"\n}"
},
{
"title": "Template Syntax",
"body": "FastMode templates use Handlebars-style tokens. There are three types of templates:\n\nStatic pages (pages/): Fixed HTML with optional data-edit-key attributes for inline CMS editing and optional {{#each}} loops for dynamic content.\nIndex templates (templates/): Collection listing pages. MUST contain at least one {{#each collectionSlug}} loop.\nDetail templates (templates/): Single item pages. MUST contain CMS tokens like {{name}}, {{{body}}}, etc."
},
{
"title": "SEO Tags — Do NOT Include",
"body": "FastMode automatically manages all SEO meta tags. Including them in your HTML will cause duplicate tags (bad for SEO ranking). Remove ALL of these from your templates:\n\nTagWhy to Remove![\"\"](\"/public/images/icons/arrow.svg\"){kind=icon}
\n\n2. CMS content images — post images, team photos, product images managed through the CMS:\n\n\n{{#if image}}\n ![\"Product\"](\"/images/product-placeholder.jpg\")
\n