Lena OkaforRD

Maia docs

Updating Maia

Get new versions of Maia and keep your content safe while you update.

Updates are free for buyers. When a new version is released, download it again from the link in your purchase email or from your Lemon Squeezy orders.

Before you update

Commit your project to Git, or copy the whole folder somewhere safe.

If you changed content and settings only

Your own work lives in a few places:

  • src/site.config.ts
  • src/content/ (programs, recipes, posts)
  • src/data/ (testimonials, FAQs)
  • src/assets/ (your photos)
  • src/pages/privacy.md and src/pages/disclaimer.md
  • public/ (favicon, share image)
  • site and any font changes in astro.config.mjs
  1. Unzip the new version into a new folder.
  2. Copy those files and folders from your project into it, replacing the samples.
  3. Run npm install, then npm run dev, and check everything looks right.
  4. Read the release notes. If a new setting was added, npm run dev tells you which file needs it.

If you changed the design

Compare your changed files with the new version and copy your changes across. In VS Code, select two files in the explorer, right-click and choose Compare Selected.

Updating Astro

Maia is tested with the Astro version in its package.json. To try a newer one:

npx @astrojs/upgrade

Then run npm run check and npm run build. If anything breaks, go back to your saved version and wait for the next Maia release.