Skip to content

Comments

Migrate DS from Jekyll to Eleventy#2512

Open
contolini wants to merge 2 commits intomainfrom
eleventy-migration
Open

Migrate DS from Jekyll to Eleventy#2512
contolini wants to merge 2 commits intomainfrom
eleventy-migration

Conversation

@contolini
Copy link
Member

@contolini contolini commented Feb 4, 2026

Replaces Jekyll with Eleventy (the Node.js-based site generator most similar to Jekyll). Removes all the Ruby requirements from this repo.

Additions

  • Eleventy
  • PR preview GH action

Removals

  • Jekyll

Testing

  1. yarn && yarn after-install && yarn start and it should look the same as the Jekyll version of the site
  2. See the pull request preview at https://cfpb.github.io/design-system/pr-preview/pr-2512/

Notes

@github-actions
Copy link

github-actions bot commented Feb 4, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://cfpb.github.io/design-system/pr-preview/pr-2512/

Built to branch gh-pages at 2026-02-10 19:54 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@contolini contolini force-pushed the eleventy-migration branch 5 times, most recently from f513b85 to e2e9f89 Compare February 5, 2026 22:46
@anselmbradford
Copy link
Member

This looks good locally, but is it expected that the Cypress PR tests fail?

Add GH PR preview action

Remove netlify config file

Destructure Decap template props so that previews render properly

Replace the react-liquid icon injection hack with an esbuild module

Preserve the `pr-preview` dir when deploying to GH pages

The PR preview was mysteriously disappearing. Turns out that if someone
opens or touches an unrelated PR, it'll deploy to GH pages and wipe out
the PR previews from other pull requests. So now we use rsync to
preserve the `pr-preview` directory.

Eleventy uses 'collections.all' instead of 'site.pages'

Update lockfile after fixing merge conflict
@contolini
Copy link
Member Author

This looks good locally, but is it expected that the Cypress PR tests fail?

NOPE. I made some more Eleventy changes on the editing interstitial page. Tests should pass now.

@contolini contolini force-pushed the eleventy-migration branch 2 times, most recently from 4166e73 to eb0ba82 Compare February 10, 2026 19:47
@contolini contolini marked this pull request as ready for review February 11, 2026 02:09
with:
node-version: 22

- name: Set up Ruby for Jekyll
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❤️

margin: 2rem 0 1rem;
}

/* Pygments via Jekyll */
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is this code comment in reference to? Can the CSS below go?

@anselmbradford
Copy link
Member

On the PR preview, any idea what's going on with the icon here?

Jekyll:
Screenshot 2026-02-11 at 3 30 16 PM

Eleventy:
Screenshot 2026-02-11 at 3 30 18 PM

@wpears
Copy link
Member

wpears commented Feb 11, 2026

any idea what's going on with the icon here?

I don't know why, but there's a bunch of stray <br/>s being added

@itsmedavep
Copy link
Collaborator

itsmedavep commented Feb 12, 2026

I also see some inconsistencies between the PR preview and the Jekyll site:

Icon size is different and some of the rows are of differing size in the PR preview page. I also see some of this {: class="icon-table"} repeated at the end of the tables here: https://cfpb.github.io/design-system/pr-preview/pr-2512/foundation/iconography/

Screenshot 2026-02-12 at 9 32 26 AM

Interestingly, pulling the branch and building looks the same as the live site (for the above images).

@itsmedavep
Copy link
Collaborator

itsmedavep commented Feb 12, 2026

FWIW I did a quick qa pass of the website.
I pulled down the branch did yarn && yarn after-install && yarn start and verified that it all looks like the DS website.


Different issue, or maybe this is to be expected, but the PR preview link now 404s when I visit it.

I don't see the pr-preview/ dir on gh-pages. It occured to me that it may be that the whole gh-pages branch may be getting overwritten either by the bulid script or the pr-preview action. Might be something to look into.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

4 participants