Skip to content

al-folio v1.0

Latest
Latest

Choose a tag to compare

View all tags
@alshedivat alshedivat released this 02 Jun 04:31
· 3 commits to main since this release
v1.0
8155e31
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

al-folio v1.0 🎉

v1.0 is a major architecture release. al-folio moves from a single monolithic theme repo to a thin starter + plugin ecosystem, while preserving the visual identity and core behavior of the theme.

What changed

  • The starter is now orchestration-only. This repo owns starter wiring (Gemfile, _config.yml), sample/demo content, user-facing docs, and the cross-plugin integration + visual-regression tests. All runtime, layouts, includes, styles, and feature logic move into versioned gems published on RubyGems.
  • Runtime split into plugins. al_folio_core provides the shared theme runtime/layout primitives and the v1 config contract, and delegates features to owning gems: al_folio_distill (Distill), al_folio_cv (CV), al_search (search), al_icons (icons), al_cookie (consent), al_img_tools (image/lightbox), al_math (math/TikZ), plus al_analytics, al_charts, al_citations, al_comments, al_newsletter, al_ext_posts, and al_folio_upgrade.
  • Tailwind-first styling. A Tailwind v4 runtime replaces the old Bootstrap/SCSS pipeline; jQuery-dependent runtime paths are removed. Legacy Bootstrap markup is supported during migration behind the optional al_folio_bootstrap_compat (off by default; supported through v1.2, removed in v2.0).
  • Upgrade & migration tooling. The bundled al-folio CLI (al_folio_upgrade) provides config-contract checks, ownership/override drift detection, legacy-marker detection, and safe codemods: bundle exec al-folio upgrade audit | apply --safe | report.
  • Docs & contributor model updated for the v1 ownership boundaries (docs/BOUNDARIES.md is the source of truth).

Upgrading an existing site

Sites created from previous versions should follow the migration guide in docs/INSTALL.md and run bundle exec al-folio upgrade audit to surface required changes. Customized forks: see the v1 migration workflow in docs/ and acknowledge any intentional local overrides with al-folio upgrade overrides accept (commit .al-folio-overrides.yml).

Included post-upgrade fixes

This release also folds in fixes to regressions found after the initial v1.0 merge:

  • Navbar / Tailwind spacing — production CSS minification (cssminify2) was corrupting Tailwind calc(var(--spacing)…) and breaking the fixed navbar; the starter now disables redundant CSS re-minification (#3634), with a production-mode regression test.
  • Plugin fixes (pinned here): al_folio_core 1.0.10 (de-jQuery the publications "more authors" control and the responsive-image fallback; fix main.css cache-busting), al_charts 1.0.1 (de-jQuery Chart.js setup), al_folio_distill 1.0.2 (de-jQuery distill overrides).

What's Changed

new features 🚀

other changes 🛠️

New Contributors

Full Changelog: v0.16.3...v1.0

Contributors

martin-mfg, alshedivat, and 15 other contributors
Assets 2
Loading