Skip to content

Migrate DEVGUIDE from Materialize to Tailwind CSS via calconnect-theme gem#84

Merged
ronaldtse merged 9 commits intomainfrom
migrate/calconnect-theme
May 5, 2026
Merged

Migrate DEVGUIDE from Materialize to Tailwind CSS via calconnect-theme gem#84
ronaldtse merged 9 commits intomainfrom
migrate/calconnect-theme

Conversation

@ronaldtse
Copy link
Copy Markdown
Contributor

Summary

Migrates DEVGUIDE from Materialize CSS + jQuery to Tailwind CSS v4 + Vite using the shared calconnect-theme gem.

Changes

  • CSS Framework: Materialize CSS → Tailwind CSS v4
  • Build Pipeline: Standard Jekyll SCSS → Vite + jekyll-vite
  • JS: jQuery + Materialize init.js → Vanilla JS (theme.js, navigation.js)
  • Fonts: Ek Mukta + Hind + Roboto → Inter + JetBrains Mono
  • Theme Gem: Adopts calconnect-theme for shared layouts, includes, SCSS, and JS
  • Dark Mode: New dark/light mode toggle with localStorage persistence
  • Navbar: Materialize deep-purple nav → Glass navbar with dark mode toggle

Files Changed

  • Rewrote all layouts (default, toc-type, toc, page, home, post) with Tailwind
  • Rewrote all includes (head, header, footer, script, toc-sidebar) with Tailwind
  • Added Vite/Node tooling (package.json, vite.config.ts, postcss.config.js, config/vite.json)
  • Created _frontend/ with Tailwind entrypoints and JS
  • Deleted vendored Materialize CSS (32 SCSS files), jQuery, Roboto fonts (10 files)
  • Updated CI workflows with Node.js setup and calconnect-theme checkout
  • Default branch changed from master to main

Dependencies

…e gem

- Replace Materialize CSS + jQuery with Tailwind CSS v4 + Vite
- Adopt calconnect-theme gem for shared layouts, includes, SCSS, and JS
- Rewrite all layouts and includes with Tailwind utility classes
- Add Vite/Node.js tooling (package.json, vite.config.ts, postcss.config.js)
- Create _frontend/ with Tailwind entrypoints, theme.js, navigation.js
- Delete vendored Materialize CSS, jQuery, Roboto fonts
- Update CI workflows with Node.js setup and calconnect-theme checkout
- Rename default branch from master to main
@ronaldtse ronaldtse changed the base branch from master to main May 3, 2026 12:54
ronaldtse added 8 commits May 4, 2026 14:08
- Add all theme CSS (sidebar, nav, typography, code, tables, dark mode) to application.css
- Fix toc-type.html: move nav before article so sidebar renders on left
- Redesign home page: hero section + 11 topic cards with icons + appendix strip
- Redesign navbar: 7 desktop links + grouped mobile menu with Data Formats/Protocols/More sections
- Update index.md to use layout: home
- Sidebar nav: use theme CSS classes instead of inline Tailwind utilities
- toc-type.html: wrap landing page content in .body for proper typography
- toc.html: add header styling, wrap content in .body
- page.html: wrap content in .body for typography styling
- post.html: add border-bottom header, use post-content class
- toc-mainPage-placeholder: add proper link styling
- Navbar: iCalendar, CalDAV, CardDAV, Scheduling, Contents, About
- Remove 'All Topics' and 'Contribute' from navbar
- Add About link to calconnect.org/about
- Footer: add CalConnect column with calconnect.org, About, Standards Registry
- Mobile menu: grouped into Standards, Formats, Protocols sections
…leased gem

- Use jekyll-calconnect-theme ~> 0.2 (released gem, not local path)
- Migrate sidebar to data-file-driven approach (_data/navigation_sidebar.yml)
- Restructure pages to lowercase URL scheme (CalDAV/ → caldav/)
- Move appendixes to resources/ pages (glossary, links, standards, examples)
- Move calendar-spam to top-level page, add about/ section
- Remove mainParent/childs front matter from all pages
- Delete obsolete includes (toc-sidebar, toc-entry, toc-mainPage-placeholder)
- Update all layouts to use theme's sidebar-nav.html
- Clean up application.css (all styles self-contained for Vite pipeline)
- Add favicon and web manifest assets
Now using released gem ~> 0.2, no local path dependency needed.
Was gitignored but jekyll-vite requires it for building.
Pages with published: false were listed in sidebar but not generated by Jekyll, causing link checker failures.
@ronaldtse ronaldtse merged commit 7a03057 into main May 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant