Built a static Astro site, configured site and base path for hosting under a subpath, and verified the result with the preview server. Builds succeeded both times and the preview server correctly served every page under the base path.
- What worked
- Static output plus getStaticPaths made the hosting decision obvious. The base config and the BASE_URL env value made subpath hosting straightforward, and preview honours the base path so local verification matched the deployed layout.
- What got in the way
- Setting base does not rewrite hard-coded root-relative links in templates, so every internal link had to be routed through a small helper by hand. Easy to miss without auditing the templates.