Skip to content

Releases

v2.1.1

Choose a tag to compare

@amirhs1 amirhs1 released this 06 Nov 20:14
270c8dc

Added

  • The template identity check, scripts/check-template-placeholders.rb, warns
    while index.html, projects.html, about.html, contact.html, or
    search.html still carries the template's own title, SEO title, or
    description, which would otherwise put "Eyvan" in your site's <title>,
    og:title, and meta description (#188). Like its other warnings, it never
    fails the deploy.

Fixed

  • The Contact page's "Email me" button now has an accessible name that starts
    with its visible text, "Email me, Your Name", so speech-input users can
    activate it by what they see (#186). The site-level axe tests now also scan
    the About, Contact, Projects, tag archive, and 404 pages.
  • The Google Scholar icon no longer repeats one id on every page it appears
    on (#186).
  • The share block is now a group named "Share this post", and two divs on
    the About page no longer carry names their role cannot have (#186).
  • The theme toggle reports its state once: its name stays "Dark theme" and
    aria-pressed is true while the dark theme applies, instead of a label
    that also changed with the theme (#186).
  • Printing or saving as PDF with the dark theme on now uses the light-theme
    colours, instead of near-white text on white paper (#191).
  • The navigation marks the current page with aria-current whether a URL in
    _data/navigation.yml ends with a slash or not (#189). It no longer calls a
    filter Liquid does not have, which also stopped builds that set
    strict_filters.
  • With no image in _data/hero.yml, the hero shows the shipped
    hero-placeholder.webp, instead of requesting a .jpg that does not exist
    (#189).
  • The author avatar in post metadata reserves its space with width and
    height, and has an empty alt while the author's name is shown beside it
    (#189).
  • The About portrait reserves its space too: about.html reads
    image_width and image_height from its front matter, set to the shipped
    avatar's 300 × 300 (#193). Update both if you replace the portrait.
  • Post titles, descriptions, and tag names render as the same text on cards,
    in post navigation, and in tag links as on the post page, even when they
    contain &, <, or " (#183). _includes/section-heading.html now escapes
    its title, eyebrow, and description too (#189); pass HTML through
    description_html instead.
  • A local build no longer copies AGENTS.local.md or CLAUDE.local.md into
    _site, and scripts/check-built-output.rb fails a build that contains
    either (#183).
  • The font-smoothing Sass mixin compiles: it read its settings from the
    wrong module, so the first @include broke the build (#184).
    _sass/3-base/_base.scss now uses it, with the same compiled CSS.
  • The README's "Configuration" list and Setting Up Eyvan now cover
    _data/about.yml, which holds the About page's text (#188).
  • The Iceland field-notes demo post no longer loads MathJax, since it has no
    math (#188).

Changed

  • CI and the deploy workflow's search-index step run on Node.js 24, read from
    the new .nvmrc, instead of Node.js 20, which reached end of life on
    2026-04-30 (#185). Each SHA-pinned Action's comment now names its exact
    release.
  • The theme toggle is icon-only everywhere: _includes/theme-toggle.html no
    longer takes hide_label, and the visible .c-theme-toggle__label is gone
    (#192). The parameter never took effect, so sites see no change; drop
    hide_label=… from any of your own calls to the include.

Security

  • The X, LinkedIn, and Pinterest share popups open with noopener, so the
    opened page no longer gets a window.opener reference to your post (#183).

Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.1.1 section — identical

v2.1.0

Choose a tag to compare

@amirhs1 amirhs1 released this 04 Nov 13:00
717c094

Added

  • A read_time_override front matter field that replaces the estimated minutes
    in a post's "N min read" text with a whole number you set (#148). It changes
    only the number: read_time: false still hides reading time. If your fork
    has its own copy of _includes/entry-meta.html, copy the new
    override_minutes lines into it.
  • Optional full-text search of posts with Pagefind,
    off by default (#153). Set search: true in _config.yml to add a
    /search/ page, a search link at the right end of the desktop header, and
    a search field at the top of the mobile menu. Pagefind 1.5.2 is a new
    development dependency. When the build contains /search/, the deploy
    workflow sets up Node.js and builds the index; see "Search" in README.md
    to preview it locally.
  • scripts/check-built-output.rb fails a build that ships any search page,
    script, index, or markup while search is off, and takes the config path
    as an optional second argument (#153).
  • When google_analytics is set, a banner asks visitors whether to allow
    Google Analytics, and an "Analytics preferences" button in the footer lets
    them change their choice later (#152). The banner's text is in
    _data/analytics.yml.
  • A weekly workflow, .github/workflows/link-check.yml, that builds your site
    and reports dead links to other sites, such as citations and references in
    posts, in its job summary (#146). A broken link turns that run red; it never
    blocks a merge or a deploy. It uses lycheeverse/lychee-action 2.9.0, and
    its settings are in .lychee.toml. GitHub disables scheduled workflows in
    forks by default: to turn the check on, open the Actions tab, choose
    Check External Links, and choose Enable workflow. See "External Link
    Check" in README.md to run it on demand or turn it off.

Fixed

  • In a crowded desktop header, such as one with five navigation links or a
    search link, the navigation no longer shrinks under the theme toggle; the
    brand text shortens with an ellipsis instead (#153).
  • Pages that use layout: page and have a date or author no longer show
    "N min read" (#151). The layout passes show_read_time=false to
    _includes/entry-meta.html, which turned it back into true; any layout of
    yours that passes it now hides the read time too. If your fork has its own
    copy of _includes/entry-meta.html, copy the new show_read_time lines into
    it.
  • The "Setting Up Eyvan" post and the first comment in _data/footer.yml no
    longer say the footer takes links, such as a privacy policy; the file holds
    only the footer's tagline and copyright text (#154).

Changed

  • For sites that set google_analytics: the Google tag now loads only
    after the visitor accepts, so nothing is requested from Google before then,
    and visitors who decline or never choose are not counted (#152). Declining
    deletes the _ga and _ga_* cookies. If your site already asks for consent
    another way, set google_analytics_consent: false in _config.yml to load
    the tag on every page as before.
  • The desktop theme toggle moved from before Home to the right end of the
    header, after the social links and, when search is on, after the search
    link (#158). Tab now reaches it last in the header. If your fork has its own
    copy of _includes/header.html, move its o-site-header__theme block to the
    end of o-site-header__actions to match.

Security

  • joi 18.2.9 → 18.3.1, a development dependency reached through wait-on,
    which clears the high-severity advisory GHSA-4528-x5fx-h6hg reported against
    18.0.0 to 18.3.0 (#157).

Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.1.0 section — identical

v2.0.0

Choose a tag to compare

@amirhs1 amirhs1 released this 03 Nov 16:21
fabe119

Breaking changes

Each item below can break a site built on Eyvan. Follow its migration step
when you merge this release into your fork.

  • The .animate motion class is now .u-animate (#26). If your content,
    overrides, or CSS use animate, rename it to u-animate.
  • Breaking for forks that customize the post layout: the post page's
    content grid moved from _sass/5-components/_post.scss to a new
    _sass/6-layouts/_post.scss, and its classes were renamed from
    c-post-layout* to l-post* (l-post, l-post__col,
    l-post__col--left, l-post__col--main, l-post__col--right,
    l-post__prose, l-post__aside) (#125). If your site overrides
    _layouts/post.html or _includes/post-toc-desktop.html, or adds CSS
    for .c-post-layout*, rename those classes. Rendering is unchanged.
  • The Sass variables $anim-speed and $anim-easing are removed, so Sass
    that uses them no longer compiles (#129). Use $transition-base from
    _sass/0-settings/_config.scss instead.
  • The Sass variables $static-stack-xxs, $static-stack-xs, and
    $static-stack-sm are removed (#129). Use the equal $space-stack-xxs,
    $space-stack-xs, and $space-stack-sm from
    _sass/0-settings/_spacing.scss instead.
  • The .c-theme-toggle--mobile, .c-nav--mobile, and
    .c-social-links--mobile modifiers now carry the mobile menu's look
    wherever they are used, and the Contents toolbar's compact share styles
    now need the new c-post-share--collapsed class (#127). If you style
    these modifiers outside the menu, check them; if your fork has its own
    copy of _includes/post-share.html, add c-post-share--collapsed to its
    root when collapse is set, as the template's copy now does.
  • The About portrait caption and the contact page's "Also reachable on"
    label now take their type from component classes, and
    .l-about__portrait-caption is removed (#123). If you have customized
    about.html or contact.html, give the portrait figcaption the class
    c-prose-caption and the label c-label alongside
    l-contact__social-label.
  • CI now runs bundle exec bundle-audit check --update as a blocking step
    (#137). A known advisory against your Gemfile.lock fails the build until
    you update the gem or record a waiver in .bundler-audit.yml.
  • @axe-core/playwright 4.14.0 turns on the label-content-name-mismatch
    rule (#69). A link whose aria-label does not contain its visible text
    now fails npm run test:a11y; remove the label or make it include the
    visible text.
  • New CI checks can fail on a fork's own changes:
    • The component gallery scan checks its page list against /tests/
      (#97). If you delete gallery fixture pages, update galleryPages in
      tests/component-gallery.spec.js.
    • npm run test:site counts characters per line in running text (#116).
      With a different body font, the failure message names the
      $text-measure-wide value that averages about 66 characters.
    • scripts/check-color-contract.rb fails when a post or a root Markdown
      file names a --color-* property that the base layer does not emit
      (#28). Rename or remove the property in that file.
    • scripts/check-color-contract.rb checks the post-navigation text at the
      far edge of its gradient (#131). A palette change that lowers that
      contrast below WCAG 2.1 AA now fails CI.

Added

  • A mq-down Sass mixin that ends just below a breakpoint, beside mq-up
    (#114).
  • A .c-label component for small uppercase labels (#123).
  • Sass tokens for control sizes, icon sizes, and the hover and press offsets
    ($control-size-sm/md/lg, $icon-size, $icon-size-lg,
    $control-lift-hover, $control-press-offset, $control-press-scale)
    (#133).
  • An axe scan of every component gallery page in CI, in light and dark, at
    1280 × 720 and 390 × 844, run with npm run test:gallery (#97, #111).
  • A "Component Gallery" section in the README, and documentation of
    .is-shrunk as an opt-in hook for your own shrink-on-scroll (#27).
  • A "Using the palette in your own components" section in the Theming
    Eyvan
    post (#28).

Fixed

  • The "Add a new component" example in the architecture post now uses tokens
    that exist, so copying it gives a styled component (#28).
  • Cross-reference numbers count only captioned figures, video, and audio,
    so they match the visible labels; a reference to an uncaptioned figure now
    shows its id (#103).
  • The mobile menu and the mobile Contents panel close, and release the page,
    when the window widens past the layout breakpoint (#104).
  • Tag links use jekyll-tagging's tag_url filter, so tags such as C++ or
    Café no longer link to a missing page (#105).
  • Share links encode titles that contain #, &, or + (#106).
  • The template identity check in the deploy workflow no longer fails on a
    date in _config.yml or _data/ (#107).
  • Prose tables that overflow their column can be reached and scrolled with
    the keyboard (#110).
  • Task-list items no longer turn inline code into small scroll boxes on
    narrow screens (#112).
  • Native controls, such as task-list checkboxes, follow the chosen theme
    instead of the operating system's (#113).
  • At exactly 480, 768, and 1024px, pages no longer show the mobile and
    desktop layouts at once (#114).
  • The Contents rail stays readable just above the layout breakpoint (#116).
  • On the About page below 1024px, the portrait caption no longer runs past
    the photo (#123).
  • CI no longer passes ruby/setup-ruby the ruby-version-file input, which
    it does not accept, so the Setup Ruby step stops logging an "Unexpected
    input" warning; Ruby is still read from .ruby-version (#142).

Changed

  • The post and About reading measure is now about 66 characters per line
    ($text-measure-wide from 75ch to 50ch) (#116).
  • The brand link is named by its visible name and role; the
    aria-label="Go to homepage" is removed (#94).
  • Transitions use one easing curve, cubic-bezier(0.4, 0, 0.2, 1), with
    their durations unchanged, and .u-animate uses it too (#129, #133).
  • In the dark theme, the Contents and share rails are one step lighter than
    the page (--color-surface-container-low) (#131).
  • A bare hr outside post prose has 2rem of space below it, as above it;
    posts are unchanged (#121).
  • Links use the shared focus-ring mixin, so re-theming
    --color-focus-ring-color now reaches links too; no visual change (#25).
  • CI runs on ubuntu-24.04 (#49), waits for the server through
    npm run test:wait (#64), and skips its Playwright steps on pull requests
    into develop that change only documentation (#136).
  • Build dependencies: sass-embedded 1.101.0 → 1.106.1 (#38, #67) and
    jekyll-feed 0.17.0 → 0.18.0 (#41).
  • CI actions: ruby/setup-ruby 1.313.0 → 1.335.0 (#39, #68, #135),
    actions/checkout 6.0.3 → 7.0.1 (#40), actions/setup-node 6.4.0 →
    7.1.0 (#43, #57), actions/deploy-pages 5.0.0 → 5.0.1 (#45), and
    actions/upload-artifact 7.0.1 → 7.0.2 (#56).
  • Test tools: @playwright/test 1.60.0 → 1.64.1 (#42, #58, #66),
    @axe-core/playwright 4.11.3 → 4.14.0 (#46, #69), wait-on 9.0.10 →
    9.5.1 (#44), axios 1.17.0 → 1.20.0 (#47), and joi 18.2.1 → 18.2.9
    (#48).
  • Contributor and agent tooling: agent rules and skills, AI-POLICY.md, a
    commit-message hook, pull request and issue templates, and Dependabot
    pull requests aimed at develop (#30, #32, #34, #36, #55, #59, #61, #81,
    #87, #88, #89, #92, #99, #100).
  • THIRD_PARTY_NOTICES.md records the source and terms of four shipped
    images: the portrait and hero placeholder (Pexels License), the default
    Open Graph image (MIT), and the quantum entanglement post cover
    (CC BY-SA 4.0) (#141).

Security

  • addressable 2.9.0 → 2.9.2, which clears seven advisories reported
    against 2.9.0 (#137).
  • follow-redirects 1.16.1 → 1.16.2, a development dependency, which clears
    the high-severity advisory GHSA-mrwp-f3q8-3g9p reported against 1.16.0
    and 1.16.1 (#139).

Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.0.0 section — identical

Eyvan v1.1.0

Choose a tag to compare

@amirhs1 amirhs1 released this 22 Jun 16:23
3c4951d

Added

  • A "Multi-image figure grids" walkthrough in the Front Matter Field
    Reference
    demo post, documenting the images="…" parameter, its
    pipe-delimited path | alt | WxH | srcset | sizes row format, and the
    cols option — the one figure.html surface that previously had no
    step-by-step guide outside the include's own comment header.
  • A step-by-step custom-domain / CNAME section in the README, covering the
    CNAME file, GitHub Pages settings, the apex/subdomain DNS records, and the
    baseurl: "" adjustment a root-served custom domain requires.
  • Development-only test layout, navigation data, and component harnesses that
    exercise the visual system without publishing test pages or helper CSS in
    production builds.
  • Documentation for the og_image front matter override and its precedence
    over visible post covers and the site-wide social fallback.

Removed

  • The pa11y-ci development dependency and its a11y / a11y:sitemap npm
    scripts. The accessibility gate is Playwright + axe (npm run test:a11y),
    which pa11y-ci duplicated without being wired into any CI workflow;
    removing it also clears the high-severity undici advisory it pulled in
    transitively through cheerio, and reconciles the tooling with the
    project's documented "Playwright + axe" accessibility policy. The README
    contributor-QA note and the dependabot.yml npm comment were updated to
    match.
  • The unused Barlow Condensed 900 (Black) weight: its @font-face block, the
    $font-weight-black token, the shipped Barlow-Condensed-normal-900-latin.woff2
    subset, and its entry in the bundled font-license map. No component
    referenced the weight (headings use Bold/700, the hero uses Semi-Bold/600),
    so dropping it trims the shipped font payload with no visual change.
  • Obsolete Sass selectors and rules, including the unused page title/subtitle
    selector API and stale state, animation, and print styles superseded by the
    canonical components and utilities.

Fixed

  • The 404.html error-code line no longer relies on a presentational <br>
    for spacing, and finally renders in the intended muted color. It used a
    u-text-muted class that was never defined anywhere in the Sass, so the
    text was not actually muted; a new _sass/5-components/_404.scss gives the
    404 component its missing home, spacing the .c-404__code line and coloring
    it with the existing --color-on-surface-variant token.
  • Generic pages now fill the same container width as the homepage, projects,
    about, and contact pages; long-form posts retain their intentionally narrower
    prose measure.
  • The entry-meta component now emits the valid flex-wrap: nowrap value instead
    of the invalid unwrap declaration.
  • The climate demo enables cross-reference resolution, so its numbered table
    reference renders a reader-facing label instead of the raw element id.
  • Development harness fixtures now use valid assets, unique landmarks, and
    accessible component states exposed by the expanded test crawl.

Changed

  • post-card.html now accepts an optional eager parameter. The homepage
    project grid sets it on the first card so the likely above-the-fold LCP
    cover loads eagerly with fetchpriority="high", while every other card
    keeps loading="lazy". Behavior is unchanged for all existing callers,
    which omit the parameter and stay lazy.
  • Sass architecture now uses consolidated semantic tokens, corrected BEM names,
    normalized component filenames and headers, and clearer boundaries between
    settings data, layout objects, components, and development-only test styles.
  • The setup, theming, architecture, README, and contributor guidance now match
    the shipped navigation split, optional-image behavior, image loading policy,
    deployment choices, Playwright/axe QA workflow, and repository rulesets.

Eyvan v1.0.0

Choose a tag to compare

@amirhs1 amirhs1 released this 17 Jun 17:48
2707368

First public release of the Eyvan Jekyll template.

See CHANGELOG.md for the full list of changes.