Skip to content

Redesign and modernise quantecon.org#194

Open
mmcky wants to merge 11 commits intomainfrom
redesign
Open

Redesign and modernise quantecon.org#194
mmcky wants to merge 11 commits intomainfrom
redesign

Conversation

@mmcky
Copy link
Copy Markdown
Collaborator

@mmcky mmcky commented Mar 30, 2026

Summary

Refresh the site visual design and content, based on John's feedback about re-optimising the website for accessibility and modern design. Reference sites: Kaggle, HuggingFace, DrivenData.

Visual & Layout

  • Full-screen hero (100vh) with updated tagline and 3 CTAs (Lectures, Workshops, Books)
  • Always-visible navbar logo with reordered navigation: Lectures | Workshops | Books | Projects ▼ | About ▼ | News
  • New card-based component system (.qe-card, .qe-badge, .qe-btn, .qe-section)
  • Metrics bar on homepage (8 Lecture Series, 5+ Books, 30+ Workshops, 2 Code Libraries)
  • Redesigned 4-column footer (Branding, Resources, Organization, Connect)
  • Consolidated from 3 icon libraries down to Bootstrap Icons only
  • CSS custom properties for brand colours
  • Scroll-down chevron indicator on hero

Pages Updated

  • Homepage: dynamic lecture grid, featured books with NEW badges, workshops section, open source projects, latest news cards
  • News: card-based layout with inline expand/collapse (no page navigation), coloured tag pills (news/lectures/workshop/books/tools/announcement), year-grouped archive accordion for older posts
  • Post: clean article layout with metadata header, max-width for readability, share on X button
  • Books: wider card layout with cover images, author info, NEW badges
  • Workshops: recent workshops with descriptions, older grouped by year in accordions
  • About: expanded with sections for mission, history, affiliations, get involved
  • Infrastructure: rewritten with simplified timeline component
  • Team: removed Swiper testimonials, added open positions CTA

Technical

  • Removed 11 unused CDN libraries (AOS, Swiper, Boxicons, Remix Icons, GLightbox, etc.)
  • Fixed Bootstrap JS SRI hash for 5.2.0
  • Migrated Sass @import@use
  • Simplified main.js from 202 to 87 lines
  • Updated Twitter → X branding throughout
  • Updated README.md with tag colour reference and brand colour palette

Tag Colour Reference

Tag Colour Hex
news Blue #0072bc
lectures Dark blue #306998
workshop Green #6EAC5B
books Red #D25663
tools Yellow #FCC837
announcement Dark grey #283039

Test plan

  • Review Netlify deploy preview across all pages
  • Verify hero section renders full-screen with scroll indicator
  • Verify navbar logo is visible and nav order is correct
  • Test news page expand/collapse on desktop and mobile
  • Check coloured tag pills render correctly on news cards
  • Verify books page card layout with cover images
  • Test workshop accordion expand/collapse for archived years
  • Confirm no console errors from missing CDN resources
  • Check mobile responsive behaviour across all layouts

🤖 Generated with Claude Code

Refresh the site visual design and content based on review feedback,
referencing Kaggle, HuggingFace, and DrivenData for modern patterns.

Visual & Layout:
- Full-screen hero (100vh) with updated tagline and 3 CTAs
- Always-visible navbar logo, reordered nav (Lectures | Workshops | Books)
- Card-based component system (.qe-card, .qe-badge, .qe-btn, .qe-section)
- Metrics bar on homepage (8 Lecture Series, 5+ Books, 30+ Workshops, 2 Code Libraries)
- 4-column footer (Branding, Resources, Organization, Connect)
- Consolidated icon libraries (3 → Bootstrap Icons only)
- CSS custom properties for brand colours
- Scroll-down indicator on hero

Pages:
- Homepage: dynamic lecture grid, featured books, workshops, open source projects, latest news
- News: card-based layout with inline expand/collapse (Bootstrap collapse), coloured tag pills, year-grouped archive for older posts
- Post: clean article layout with metadata header, max-width for readability
- Books: wider card layout with cover images and NEW badges
- Workshops: recent workshops with descriptions, older grouped by year in accordions
- About: expanded with sections for mission, history, affiliations
- Infrastructure: rewritten with simplified timeline component
- Team: removed Swiper testimonials, added positions CTA

Technical:
- Removed 11 unused CDN libraries (AOS, Swiper, Boxicons, Remix Icons, GLightbox, etc.)
- Fixed Bootstrap JS SRI hash for 5.2.0
- Migrated Sass @import to @use
- Simplified main.js from 202 to 87 lines
- Updated Twitter → X branding throughout
- Updated README with tag colour reference and brand palette

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 30, 2026 04:06
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 30, 2026

Deploy Preview for grand-swan-ca5201 ready!

Name Link
🔨 Latest commit 5a99525
🔍 Latest deploy log https://app.netlify.com/projects/grand-swan-ca5201/deploys/69cda9bea1acc900081593a7
😎 Deploy Preview https://deploy-preview-194--grand-swan-ca5201.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Modernizes the QuantEcon Jekyll site theme by introducing a new component-based design system, redesigned homepage/news UX, and updated content across key pages to align with accessibility and contemporary layout patterns.

Changes:

  • Reworked layouts for Home, News (inline expand/collapse + archive accordion), Posts, Books, Lectures, Code, Team, and Footer using new .qe-* components.
  • Simplified frontend JS/CSS and removed multiple third-party CDN dependencies; updated MathJax integration and site metadata.
  • Refreshed content on About / Infrastructure / Workshops and updated social links to X.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
pages/workshops.md Adds intro + reorganizes workshops into “Recent” and accordion-based “Past” sections.
pages/infrastructure.html Redesigns infrastructure page into cards + simplified timeline.
pages/available-positions.md Updates social link to X domain.
pages/about.md Expands About page structure and content.
assets/sass/_timeline.scss Replaces legacy timeline styling with new simplified timeline styles (+ legacy support).
assets/main.scss Migrates to Sass @use, adds component system styles, and updates global layout/theme styling.
assets/js/main.js Simplifies JS (header scroll, back-to-top, mobile nav, smooth scrolling).
_layouts/team.html Removes testimonials carousel and adds positions CTA button.
_layouts/post.html Redesigns post layout with metadata header, tags, and “Share on X”.
_layouts/news.html Implements card-based news with collapsible bodies and year-grouped archive accordion.
_layouts/lectures.html Converts lecture listing to card grid.
_layouts/home.html Major homepage redesign with hero + CTAs, metrics bar, cards, and latest news.
_layouts/default.html Updates navbar/footer structure, removes unused CDNs, upgrades MathJax, updates icons.
_layouts/code.html Converts code listing to card grid.
_layouts/books.html Converts books listing to card layout with cover images and “NEW” badge.
_config.yml Updates site description.
README.md Adds development notes, tag palette reference, and brand colour table.
Gemfile Bumps Jekyll requirement and removes minima dependency.

@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Mar 30, 2026

Comments from @jstac email

  • Is there a way to 'fade' the background image so that the text / buttons / etc stand out more?
  • Maybe drop the words 'Browse' and 'Explore' on the buttons?
  • Maybe add a button called 'Code'

@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Mar 30, 2026

All three items addressed:

  1. Fade the background image — Added a dark overlay (rgba 0,0,0,0.45) on the hero so text and buttons stand out more clearly.
  2. Drop "Browse" and "Explore" — Hero buttons now just say "Lectures", "Workshops", "Books".
  3. Add a Code button — Added a fourth CTA button linking to /code/.

mmcky added 6 commits March 31, 2026 08:49
Copilot review fixes:
- Replace outline:none/box-shadow:none with :focus-visible styles (a11y)
- Change dropdown toggles from <a> to <button> for keyboard access
- Add rel='noopener noreferrer' to all target='_blank' links
- Fix heading hierarchy in workshops (h2 -> h3 for titles)
- Add missing accordion wrapper id for news archive
- Render excerpts instead of full content for older posts
- Guard smooth-scroll against bare '#' hash

jstac feedback:
- Add dark overlay on hero background image
- Simplify hero button labels (drop Browse/Explore)
- Add Code CTA button to hero

Also: add .claude to .gitignore
Repositioned Chow Institute sponsorship from the bottom of the page
to a prominent inline banner directly below the metrics bar. Styled
as a compact horizontal strip with 'Supported by' label.
- Fixed bar above header on all pages with Chow Institute credit
- Session-only dismiss via sessionStorage (reappears next session)
- Dark navy-slate background (#1e2d3a) for Safari toolbar harmony
- CSS variable --sponsor-bar-height for dynamic header/content offset
@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Mar 31, 2026

Feedback from @HumphreyYang


I just tried to see what it would look like on a phone, and I spotted that the past workshop section seems to not be responding to the layout change with text overflow:

https://deploy-preview-194--grand-swan-ca5201.netlify.app/workshops/

image

It might be a minor issue with the .workshop container div or accordion structure?

@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Mar 31, 2026

Comments from @DrDrij


  1. Set badges to start on a new line for consistency, depending on your browser width the badges can appear in different places (see attached)
    Add the following to .qe-badge
    display: block;
    width: fit-content;
    margin: 0.5rem 0;
  2. Add some simple small icons to the “Open Source Projects” panel (similar layout to “Books & Textbooks)
  3. I LOVE the stats panel just below the hero image, can there be a big number too? eg. 360K yearly readers, 0.6 million downloads
  4. Add target=“_blank” to the link on the Paula and Gregory logo (external sites to open in a new window)
  5. Add a link to home in the mobile hamburger navigation
  6. Make the close and hamburger icons ‘on top’ of each other so the touch target to open/close is in the same spot
  7. Center the hero buttons on mobile, add justify-content: center; to the buttons container
    so they spacing displays evenly
  8. Mobile menu - it looks like the sections with children have their title hidden, suggest removing the lines commented out below (See screenshot)
    .navbar .dropdown .dropdown-toggle {
    display: flex;
    align-items: center;
    /* justify-content: space-between; /
    /
    padding: 0 3px; /
    font-family: "Roboto", sans-serif;
    /
    font-size: 15px; /
    font-weight: 600;
    /
    color: hsla(0, 0%, 100%, .7); /
    /
    white-space: nowrap; */
    transition: .3s;
    position: relative;
    background: none;
    border: none;
    cursor: pointer;
    }
image image image image

- Fix workshop text overflow on mobile: remove min-width: 400px (HumphreyYang)
- Set .qe-badge to display: block with fit-content for consistent placement (DrDrij #1)
- Add target=_blank to Chow sponsor logo link on homepage (DrDrij #4)
- Add Home link in mobile nav, hidden on desktop with d-lg-none (DrDrij #5)
- Fix hamburger/close icon position: use position: fixed for stable touch target (DrDrij #6)
- Center hero buttons on mobile below 575px (DrDrij #7)
- Restore full dropdown-toggle styles in mobile nav for visible parent items (DrDrij #8)
@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Mar 31, 2026

Feedback addressed in commits 038cc17 and fc3eb7e

@HumphreyYang

  • Workshop text overflow on mobile — Fixed by removing min-width: 400px from .workshop-details ul, so the list reflows naturally on narrow screens.

@DrDrij

  1. Badges on new line — Changed .qe-badge to display: block; width: fit-content; margin: 0.5rem 0 for consistent placement regardless of viewport width.
  2. Icons on Open Source Projects panel — Tracked in Add icons to Open Source Projects section on homepage #195. Current language-based icons are fine for now.
  3. Big numbers on metrics bar — Tracked in Add prominent usage metrics to homepage metrics bar #196. Need to confirm accurate figures before adding.
  4. target="_blank" on Chow sponsor logo — Added target="_blank" rel="noopener noreferrer" to the homepage sponsor link.
  5. Home link in mobile nav — Added as first nav item with d-lg-none (hidden on desktop, visible in mobile menu).
  6. Hamburger/close icon same position — Changed .navbar-mobile .mobile-nav-toggle to position: fixed with consistent top/right so the touch target stays put.
  7. Center hero buttons on mobile — Added justify-content: center on the button container below 575px.
  8. Mobile dropdown toggle styles — Restored full visible styles (display: flex, font-family, font-weight, etc.) so "Projects" and "About" titles show properly in the mobile menu.

mmcky added 3 commits March 31, 2026 13:36
Adds Bootstrap Icons (bi-code-square, bi-journal-code, bi-gear) to the three
project cards using the same d-flex layout pattern as the lecture series cards.

Closes #195
…esktop white

The desktop .navbar .dropdown .dropdown-toggle (3-class specificity) was winning
over .navbar-mobile .dropdown-toggle (2-class). Moved full property set into
.navbar-mobile .dropdown .dropdown-toggle to match specificity and ensure
Projects/About titles are visible on the white mobile menu background.
…rkshops, news tags

- Hero section: increase overlay darkness (0.45→0.55), headline size (2.5→3rem),
  weight (200→400), and add text-shadow for better readability
- Make all hero buttons use outline style for symmetry (Lectures was solid blue)
- Remove target=_blank from lecture links on homepage and lectures page
- Add Bank of Portugal (Oct 2025), Hitotsubashi (Sep 2025), and IUJ (Feb 2026)
  workshops to both the workshops page and homepage recent list
- Add tag badges to homepage Latest News cards (after date)
- Update copilot-instructions.md with workshops update note (see #197)
@mmcky
Copy link
Copy Markdown
Collaborator Author

mmcky commented Apr 1, 2026

Addressing @jstac's feedback

Changes in commit 5a99525:

1. Hero headline prominence

"the text 'Open Source Tools..' doesn't jump out at the reader as much as it might"

  • Darkened background overlay from 45% to 55% opacity to push the mountain image further back
  • Increased headline size from 2.5rem to 3rem
  • Changed font weight from 200 (ultra-light) to 400 (regular) -- this was the main issue
  • Added text-shadow for extra legibility

2. Hero button symmetry

"The 'Lectures' button is blue and the rest are white. I think I prefer symmetry."

  • Changed Lectures button from solid blue to white outline -- all four buttons now match

3. Lecture links no longer open new tabs

"clicking on a lecture series opens a new tab. Now I've lived with that for a while I find it intrusive."

  • Removed target="_blank" from lecture card links on both the homepage and /lectures/ page

4. New workshops added

"Bank of Portugal and Hitotsubashi could be added to /workshops/"

  • February 2026, International University of Japan -- Computational Methods for Simulation
  • October 2025, Bank of Portugal -- Computational Methods for Macroeconomic Modeling
  • September 2025, Hitotsubashi University -- Hitotsubashi Computational Economics Workshop
  • Added to both the full workshops page and the homepage "Recent Workshops" sidebar
  • Updated intro paragraph on both pages to mention Bank of Portugal and Hitotsubashi University

Additional improvements

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.

2 participants