Extending and Development

This site is built on top of Astro with Starlight, and the pages are all written in MDX. That means we have lots of options for extending and adding interactive features to our articles.

Project Structure

• Directorysrc/

  • Directoryassets/ //static assets like images go in here

    • image.png
  • Directorycontent/

    • Directorydocs/ //articles go in here

      • article.mdx
  • Directorycomponents/ //components go in here

    • component.astro

Components

You can create a new component in a .astro file, which will automatically be rendered and optimized at build time, and can then be accessed from inside the articles. Components can accept props and even have other components or markdown nested inside them. See the Astro Components documentation for more info.

It is also possible to include components from various frontend frameworks. For performance reasons, this is reserved only for cases when highly interactive features are needed. We want to ship as little JS to the browser as possible and keep our pages lightweight.