Skip to content
Buildmere Engineering
Blog

Getting started

This is the Buildmere Engineering hub — a fast, on-brand home for net-new engineering documentation and the team blog, built with Astro and Starlight.

Why this exists

Section titled “Why this exists”

The internal Docusaurus site (apps/docs) is the workspace for the backlog and working docs. This hub is the place for durable, readable engineering content: architecture notes, build practices, and longer-form writing — with instant static search via Pagefind.

Adding content

Section titled “Adding content”
  • Docs live in src/content/docs/ as .md / .mdx. Add a file, give it title and description frontmatter, and it appears in the sidebar.
  • Blog posts live in src/content/docs/blog/. Give them title, date, and authors frontmatter; they show up at /blog/.

Authoring with the MCP server

Section titled “Authoring with the MCP server”

The docspub MCP server exposes content operations as tools (docspub_create_doc, docspub_create_post, docspub_set_publish_state, docspub_build_site, …), so an agent can draft and publish content here the same way it manages backlog tickets.

Section titled “Search”

Press / to open search. The index is built at astro build time, so search is only live on the built/preview site — not the dev server.