These guides cover the al-folio v1.x starter and its pluginized runtime.
- Quick Start: create a site from the template and get it live quickly.
- Installing and Deploying: Docker, local setup, GitHub Pages, Netlify, and upgrade guidance.
- Customizing: content, CVs, publications, layouts, local overrides, and feature configuration.
- FAQ: common deployment, upgrade, plugin, and troubleshooting questions.
- Troubleshooting: build, deployment, styling, and content debugging.
- Analytics: analytics provider setup.
- SEO: search-engine and social preview setup.
- Ownership Boundaries: starter-vs-plugin ownership, PR routing, and release responsibilities.
- Contributing: contributor workflow, validation, and agent guidance.
- Bootstrap skill: agent workflow for new v1 sites.
- Migration skill: agent workflow for customized fork migrations and override audits.
al-folio v1.x is a thin starter. It owns site wiring, example content, documentation, integration tests, and visual tests.
Runtime behavior belongs in Ruby gems maintained under the al-org-dev organization.
When changing feature behavior, route the work to the owning plugin repo first. Update this starter only when the change affects:
Gemfiledependency pins,_config.ymlplugin activation or feature flags,_data/featured_plugins.ymlcatalog metadata,- documentation, examples, integration tests, or visual parity coverage.
See Ownership Boundaries for the full routing table.