Templates are starter sites with layout, sample pages, and default styles. Pick one in step 2 of the site wizard, or skip selection to start closer to a blank canvas. You can change everything after creation.
When templates help
Templates save time when you want a sensible default structure on day one — navigation, homepage sections, and typography already in place.Choose a template when:
You are launching a docs site, blog, portfolio, or similar and want a proven layout
You prefer editing existing content over building from zero
You want to preview how Aveiro handles your use case before customizing
Start without a template when:
You have a clear structure in mind and will add pages yourself
You are experimenting and do not need sample content
You plan to rely heavily on AI to generate the first draft
In step 2 of the wizard, browse the gallery and select a card — or click Continue without selecting one to create a minimal starting point.
Template categories
Gallery templates are grouped by purpose:
Category
Best for
Documentation
Help centers, product docs, guides with sidebar navigation
Blog
Articles, posts, and editorial layouts
Portfolio
Projects, case studies, and personal or studio showcases
Store
Product-focused layouts and commerce-style pages
Spotlight
Focused landing pages and single-purpose marketing sites
Each card shows a label, description, and preview images. Some templates link to a live demo on *.aveiro.page so you can see the finished look before cloning.
What copying a template includes
When you create a site from a template, Aveiro copies into your new site:
Starter pages and folder structure
Default layout (header, footer, sidebars as configured)
Initial styles (you still pick presets in step 3)
Sample components and MDX content you can replace
The copy is yours — changes do not affect the gallery template or other users' sites.
Step 3 — styles after the template
Even with a template, step 3 lets you set primary colors, links, and related tokens before the site is created. Treat this as a first pass; the editor Styles panel has the full theme controls later.
Changing your mind later
You cannot swap the underlying gallery template after creation the way you swap themes in other tools. What you can do:
Edit or delete any page
Change layout slots in the Layout panel
Restyle the site in Styles
Duplicate the site and try a different template on the copy
If you picked the wrong template, duplicating and starting a fresh wizard with a different choice is often faster than rebuilding in place.
Template from URL
Marketplace links can include a template_id query parameter so the wizard pre-selects a specific template. Useful when sharing a “Start with this template” link from the Aveiro marketplace.
Tips
Read the description on each card — it explains the intended use case.
Match category to goal — a docs template gives you sidebar nav; a spotlight template gives you a tight landing flow.
Do not overthink it — templates are starting points; publishing quality matters more than the initial pick.
Automation can create a site from the same marketplace gallery without opening the wizard:
GET /api/v1/templates — list approved templates (slug, label, category, preview_url). Requires sites:read.
POST /api/v1/sites with name, slug, and optional template set to a marketplace slug from step 1. Requires sites:write. The new site clones pages, layout, and styles from the live template host.
In Cursor or other MCP clients, aveiro_list_templates and aveiro_create_site wrap the same routes. Prefer passing a template — blank sites only get a welcome page and default layout.
