alshedivat / alshedivat/al-folio

Inconsistent docs on how to change theme color

Open
#3,692 6 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
16.1k
Forks
13.1k
PR merge metrics
No merged PRs in 30d

Description

### Discussed in https://github.com/alshedivat/al-folio/discussions/3650

Originally posted by **EtienneC30** June 20, 2026
In the CUSTOMIZE.md file it is written [here](https://github.com/alshedivat/al-folio/blob/main/docs/CUSTOMIZE.md#changing-theme-color) that
> A variety of beautiful theme colors have been selected for you to choose from. In v1.x, theme tokens are gem-owned by default. To customize colors locally, either use _config.yml theme settings (for light/dark scheme selection) or create local _sass/_themes.scss and _sass/_variables.scss override files in your starter repo (these override gem defaults).

But there are no instructions about how to choose a color theme or what the scss files should look like. After a lot of looking I found corresponding files in my computer which I overrode as indicated I think but it did not apply the changes (when I pushed it did not even trigger the deploy job). But I feel like there should be a simpler way so I probably missed something. Any help appreciated 🙏

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.