Papyrus docs

Papyrus is a reusable Astro theme for personal sites, technical notes, project pages, and profile/CV pages. Start from papyrus-template, keep your content in that site, and let astro-papyrus provide the shared routes and components.

Read first

• Install and configure Papyrus explains the template workflow.
• Site config shows what belongs in papyrus.config.toml.
• Markdown authoring guide shows posts, code blocks, callouts, media, and source actions.
• Collections explains ordered docs or guide sections.
• Profile and CV explains the TOML-driven profile, print routes, and exports.

For developers

• Papyrus package shape explains what stays in the theme package and what stays in a site.
• Feature map maps public routes to reusable features.
• AI and mobile readiness covers search, generated metadata, mobile layout, and agent-readable files.
• Deploy Papyrus covers static hosting and production builds.

What to edit

Most sites only need these files:

• papyrus.config.toml for site identity, navigation, theme, feature flags, and homepage counts
• src/data/projects.toml for project cards
• src/content/posts/ for posts, docs, and collections
• src/data/profile.toml for profile and CV data
• public/ for images, logos, favicons, and static files

The package repo has more files because it is the theme. A site made from papyrus-template should stay much smaller.

Repo-only notes stay under .agents/; public docs live in this collection.