[@layout]: ../docs.layout.md
[@docs-items]: ../docs.components.md

# Start

Ready to make something? Create a site, watch your edits appear, and build a
complete workshop before choosing how to publish it. Start with Install if Bun
is not set up yet.

<doc-item href="/docs/start/install.guide" title="Install" description="Set up Bun and choose whether to install the optional global launcher." />
<doc-item href="/docs/start/first-site.guide" title="Quickstart" description="Create a project, run it, edit the home page, and add another page." />
<doc-item href="/docs/start/build-a-site.guide" title="Build a workshop" description="Add shared navigation, a theme, a lesson card, and Focus/Slides." />

<doc-item href="/docs/start/migrate-070.guide" title="Upgrade to 0.7" description="Migrate an existing project, preserve saved work, and copy a prompt for your coding agent." />

---

## Understand and publish your project

<doc-item href="/docs/start/project-structure.guide" title="Project structure" description="Find your content, understand typed routes, and locate project configuration." />
<doc-item href="/docs/start/runs.guide" title="How PathMX runs" description="Choose static delivery, browser-local storage, or a live server." />
<doc-item href="/docs/start/publish.guide" title="Publish" description="Export and preview static files, or supervise a live site." />

The [methodology](../methodology.md) explains the file and link conventions when
you want to understand the ideas behind them.