Skip to content

Commit 7f3476e

Browse files
committed
Update CLAUDE.md: streamline instructions, remove outdated Tailwind CSS details, clarify stylesheet structure and PostCSS incremental build integration
1 parent 60d42bd commit 7f3476e

File tree

1 file changed

+4
-12
lines changed

1 file changed

+4
-12
lines changed

CLAUDE.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,6 @@ bundle exec rake serve
2121
bundle exec jekyll serve --watch --future --incremental
2222
```
2323

24-
### CSS (Tailwind)
25-
26-
```bash
27-
# Build CSS (production)
28-
npm run build-css
29-
30-
# Watch CSS for development
31-
npm run watch-css
32-
```
33-
3424
### Testing & Quality Assurance
3525

3626
```bash
@@ -40,6 +30,7 @@ bundle exec rake test
4030
# Run individual test suites
4131
bundle exec rake test-news-plugin # News archive plugin tests
4232
bundle exec rake test-linter # Linter library tests
33+
bundle exec rake test-postcss-incremental-fix-plugin # PostCSS incremental build plugin tests
4334

4435
# Linting
4536
bundle exec rake lint # Markdown linter
@@ -83,17 +74,18 @@ bundle exec rake new_post:fr # French
8374
- `_data/`: YAML data files (releases.yml, downloads.yml, branches.yml, locales/)
8475
- `lib/`: Ruby utilities (linter, markup checker, draft release)
8576
- `test/`: Test files for plugins and linter
86-
- `stylesheets/`: CSS source
77+
- `stylesheets/`: CSS source (includes partials in underscored directories like `_components/` and files starting with `_`)
8778
- `_javascripts_src/`: TypeScript source files
8879
- `javascripts/`: Compiled JavaScript output
8980

9081
### Design System (Tailwind CSS)
9182

9283
The site uses a custom Tailwind configuration with:
9384

94-
- **Semantic color tokens** via CSS variables (defined in `tailesheets/semantic-colors.css`)
85+
- **Semantic color tokens** via CSS variables (defined in `stylesheets/semantic-colors.css`)
9586
- Accessible via `bg-semantic-*`, `text-semantic-*`, `border-semantic-*` classes
9687
- Automatically handles light/dark mode via `prefers-color-scheme`
88+
- **Incremental Build**: Uses `_plugins/postcss_incremental_fix.rb` to trigger PostCSS rebuilds when HTML, Markdown, or CSS partials (e.g., `_*.css` or files within `_*` directories) are modified during `jekyll serve --incremental`
9789
- **Brand colors**: Ruby (red) and Gold palettes
9890
- **Typography plugin** for prose styling
9991
- **Custom breakpoints**: Container max-widths configured for content layouts

0 commit comments

Comments
 (0)