The Interface Guide

This page maps the current Simple Page interface: navigation, editor tabs, settings, drafts, and history.

The top bar contains:

Area What it does
Logo Links to the site homepage. Uses your ENS avatar when available, otherwise a generated foam identicon.
Domain Shows the current ENS domain.
History icon Opens the version history timeline when the site has a repo root.
Search Appears on published pages when search is enabled in Settings. Shortcut: Cmd+K or Ctrl+K.
Edit button Appears on published pages. Opens the editor for the current page.
Hamburger menu Appears in editor mode. Opens Settings, Subscription, and Quit editor.

If the app cannot reach the configured Simple Page Node or RPC endpoint, warning banners appear above the navbar with override instructions.

Editor Tabs

The editor tab bar contains:

Tab Route Purpose
Preview /spg-edit preview mode Render local unpublished changes.
Edit /spg-edit Write markdown.
Pages /spg-pages Manage page structure.
Files /spg-files Manage uploaded files.
Agents /spg-agents Authorize CLI agent keys.
Drafts /spg-drafts Review and publish signed drafts.
Publish /spg-publish Stage and publish local changes.

On small screens, the tab bar scrolls horizontally.

Edit Tab

The Edit tab is a markdown editor with syntax highlighting, frontmatter highlighting, autosave, and an optional side-by-side preview.

Markdown

Supported markdown includes:

  • Headings: # through ######.
  • Bold and italic: **bold**, *italic*.
  • Links: [text](url).
  • Images and media: ![alt](/_files/photo.jpg).
  • Code blocks with optional language tags.
  • Blockquotes, lists, horizontal rules, and tables.
  • Raw HTML.
  • Web3 Forms with web3:// image links.

Side-By-Side Preview

Use the side-by-side toolbar button to show rendered preview next to the markdown editor. Simple Page remembers this setting in your browser.

Use absolute paths from the site root:

[Go to About](/about/)
[Read the FAQ](/learn/faq/)
[Back to Home](/)

Preview rewrites internal links so navigation stays inside the editor preview.

Frontmatter

Frontmatter goes at the top of a page between --- fences.

---
title: My Page Title
description: A short description for SEO and RSS
sidebar-toc: true
sidebar-nav-prio: 10
created: 2026-01-15
rss: true
tags:
  - tutorial
---

Supported keys:

Key Effect Default
title Page title for navigation, RSS, and browser title. Domain name or generated path title.
description Meta description and RSS summary. Empty.
sidebar-toc Show the right table-of-contents sidebar. false.
sidebar-nav-prio Include page in left sidebar and set order. Lower numbers appear first. Not shown.
rss Include page in RSS feed. Requires created. false.
created RSS publication date. None.
updated RSS updated date. None.
tags RSS categories. YAML list or comma-separated. None.
language Feed language. Read from the root page. en.

See Advanced Navigation and RSS Feeds for details.

Preview Tab

Preview renders local unpublished changes with the current template and settings.

Preview shows:

  • The current page rendered as HTML.
  • Internal navigation through local changes.
  • Uploaded media, sidebars, theme, and Web3 Forms.

Preview does not show exactly what visitors see until you publish, because visitors only receive the latest published IPFS root.

Pages Tab

The Pages tab manages markdown pages.

Creating Pages

Enter a path. Simple Page creates the corresponding index.md page.

You enter URL File
about /about/ /about/index.md
blog/first-post /blog/first-post/ /blog/first-post/index.md
docs/api/auth /docs/api/auth/ /docs/api/auth/index.md

Paths must use lowercase letters, numbers, hyphens, and slashes. /feed and /rss.xml are reserved for RSS.

Page Actions

Each page can be previewed, edited, deleted, or restored to its last published state.

Restore discards local unpublished changes for that page.

Files Tab

The Files tab manages content under /_files/.

You can:

  • Upload files by selecting or dragging them into the file list.
  • Create folders.
  • Navigate folders with breadcrumbs.
  • Preview media.
  • Copy the publish path for markdown embedding.
  • Delete files or empty folders.
  • Restore files to their published state.

Uploaded filenames have spaces replaced with underscores.

Agents Tab

Agents authorize a CLI-generated did:key to submit drafts without the ENS owner key.

The normal flow is:

  1. Run simplepage auth yourname.eth --name agent-name in the CLI.
  2. Open the printed /spg-agents URL.
  3. Connect the wallet that owns the ENS name.
  4. Choose a capability expiry.
  5. Sign the SIWE capability.

Stored capabilities are listed on the Agents page until they expire.

Drafts Tab

Drafts are signed off-chain refs submitted by authorized agents.

The Drafts page shows:

  • Latest revision per draft name.
  • Agent name.
  • Timestamp and sequence number.
  • Content CID.
  • Whether the CID looks like a Simple Page root or raw static content.
  • Preview link.
  • Publish button.

Publishing a draft requires an active subscription, the ENS owner wallet, and the expected chain. Publishing to new.simplepage.eth is disabled.

Publish Tab

The Publish tab stages local browser edits and signs the ENS contenthash transaction.

It shows:

  • Selected ENS name.
  • Changed pages.
  • Changed files.
  • Changed settings.
  • Template update toggle when a newer template is available.
  • Overwrite warning when publishing to a different domain that already has content.
  • Ownership and network checks.

When you click Publish, Simple Page builds a CAR, uploads it to a Node, prepares the resolver transaction, and asks your wallet to sign.

Settings

The Settings page has three groups.

General

  • Show donation notice controls the subscription-expiry donation prompt.
  • Enable search adds a search UI to published pages.

Appearance

  • Edit Button Style chooses rainbow text or a minimal icon.
  • Themes selects separate light and dark DaisyUI themes.
  • Theme changes apply locally immediately and are published as generated theme.css.

Advanced

  • Clear Page Edits removes unpublished page edits.
  • Clear File Edits removes unpublished file changes.
  • Clear All Data clears local edits, settings changes, and browser cache state for Simple Page.

Subscription Page

The Subscription page shows the current expiry and lets you subscribe, renew, or donate.

Subscriptions are priced at $12/year in ETH. The app sends an extra one-month fee buffer to handle ETH/USD price movement; the contract refunds excess ETH.

History Page

The History page shows indexed website versions. Each entry links to the CID and transaction information when available.

If you own the ENS name and have an active subscription, you can restore an older version by publishing that historical CID as the current ENS contenthash.

Offline Behavior

Works offline after the app has loaded:

  • Editing pages.
  • Previewing local changes.
  • Creating and deleting pages.
  • Restoring local page edits.

Requires a connection:

  • First load of a site or template.
  • Uploading files.
  • Publishing.
  • Authorizing agents.
  • Loading drafts/history from a Node.
  • Wallet and ENS interactions.