v2.0.0

A major overhaul of the template with a new theme system, enhanced reading experience, and comprehensive documentation.

What's New

• 8 accent color palettes — emerald, indigo, rose, amber, blue, violet, teal, orange. Set one value in site.js and it brands your entire site via CSS custom properties
• Reader-controlled dark mode — Light/dark/auto toggle in the footer with localStorage persistence and anti-FOUC script
• Enhanced navigation — Keyboard shortcuts (arrow keys), swipe gestures on mobile, mobile bottom nav bar, and sidebar with focus trapping
• Reading experience — Progress bar scoped to chapter content, reading time estimates, scroll-to-top button, and next-chapter prefetch at 50% scroll
• SEO & structured data — JSON-LD schemas (Book + Article), Open Graph tags, Twitter Cards, XML sitemap, robots.txt, and canonical URLs
• Accessibility — Skip-to-content link, focus-visible styles with accent color, keyboard navigation, noscript fallback, and print stylesheet
• Custom 404 page — Styled error page with chapter directory
• Chapter template — _chapter-template.md starter file for quick chapter creation
• Comprehensive wiki — https://github.com/deepakness/putout/wiki covering configuration, chapters, theming, SEO, accessibility, PDF/EPUB, and deployment

Breaking Changes

• Theme system replaced — Old themes.js (4 themes) removed. Now uses site.theme to select an accent color from accentColors.js. Update your site.js accordingly
• Permalink field — Chapters now use standard Eleventy permalink frontmatter instead of custom slug logic
• Eleventy v3 — Upgraded from v2. Requires Node.js 18+

Improvements

• Redesigned homepage hero, chapter layout, and chapter cards
• Tailwind CSS v3 with accent color utilities via CSS custom properties
• Improved PDF/EPUB generation with title page, table of contents, and page numbers
• Google Fonts as single source of truth in site.js
• Netlify config with 404 redirect handling

v1.2.0

What's changed:

• Major upgrade: Eleventy v2.0.1 → v3.1.2 (latest stable) with full compatibility testing.
• Navigation plugin: @11ty/eleventy-navigation 0.3.5 → 1.0.4 for Eleventy v3 compatibility.
• Dependencies: Updated lucide 0.541.0 → 0.542.0.
• Configuration: Fixed permalink computation for Eleventy v3 stricter falsy value handling.

v1.1

What’s Changed:

• Updated deps: tailwindcss 3.4.17, @tailwindcss/typography 0.5.16, postcss 8.5.6, autoprefixer 10.4.21, lucide 0.541.0.
• Refreshed lockfile and cleaned up transitive packages.

Verification:

• Eleventy build, Tailwind compile, and PDF/EPUB generation all succeed.

Security:

• Applied npm audit fix; remaining advisories stem from epub-gen transitive deps (no direct runtime changes here).

Heads-Up:

• Major upgrades available (Eleventy v3, Tailwind v4) deferred to avoid breaking changes; can be tackled in a follow-up.