Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .jules/bolt.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,7 @@
**Learning:** Using non-canonical URLs (e.g., those missing trailing slashes or using old repository names) triggers HTTP redirects (301, 302, 308). This adds at least one extra network round-trip (RTT), which can significantly delay page load or navigation on slower connections.

**Action:** Always use the final, canonical destination URLs for documentation and external links. Verify these URLs with `curl` to ensure they return a 200 OK status without further redirects.

## 2026-06-21 - Precision Matters in SVG Optimization
**Learning:** With SVGO 4.0.1, the default precision or precision >= 1 may result in zero file size reduction for certain assets. Using `--precision 0` was necessary to achieve a ~47% reduction for the organization logos without visual degradation. Overwriting the source files directly is preferred over creating `.min.svg` variants to avoid technical debt.
**Action:** Experiment with precision levels (starting at 0) if default SVGO passes yield no gains. Always optimize in-place for referenced assets.
Comment on lines +19 to +21

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

📝 Update SVG Optimization Guidelines

Since using --precision 0 introduces geometric distortion and breaks the symmetry of diagonal paths (e.g., turning 45-degree angles into 47.3-degree angles), we should update the journal entry and guidelines to recommend a minimum precision of 1 or 2 for logo assets.

Using --precision 1 or --precision 2 is the industry standard for vector logos to maintain visual fidelity and scalability across high-DPI displays while still achieving significant file size savings.

Suggested change
## 2026-06-21 - Precision Matters in SVG Optimization
**Learning:** With SVGO 4.0.1, the default precision or precision >= 1 may result in zero file size reduction for certain assets. Using `--precision 0` was necessary to achieve a ~47% reduction for the organization logos without visual degradation. Overwriting the source files directly is preferred over creating `.min.svg` variants to avoid technical debt.
**Action:** Experiment with precision levels (starting at 0) if default SVGO passes yield no gains. Always optimize in-place for referenced assets.
## 2026-06-21 - Precision Matters in SVG Optimization
**Learning:** With SVGO 4.0.1, using an appropriate precision level (typically precision 1 or 2) is crucial to balance file size reduction with visual fidelity. While precision 0 yields the smallest file size, it can introduce geometric distortion (e.g., breaking 45-degree diagonal symmetry) and lumpy curves on text paths when scaled. Overwriting the source files directly is preferred over creating minified variants to avoid technical debt.
**Action:** Use precision 1 or 2 as the default for logo assets to preserve geometric symmetry and smooth curves. Always optimize in-place for referenced assets.

2 changes: 1 addition & 1 deletion profile/assets/logo-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion profile/assets/logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.