style: add dark mode theme with toggle functionality

[Jorgagu]

This pull request adds full support for light and dark themes to the site, including a user-toggleable theme switcher, persistent theme preference, and dynamic styling across all major components. It introduces new SCSS variables and theme-specific styles, updates markup to support theme switching, and adds the necessary JavaScript logic for toggling and storing the user's theme choice.

Theme support and switching:

• Added a ThemeToggle button (theme-toggle.html) to the site header and implemented its styling and logic, allowing users to switch between light and dark modes and persist their preference in localStorage. [1] [2] [3] [4] [5]
• Injected theme class (theme-dark or theme-light) into the HTML root element on page load, based on user preference or system settings, and loaded the theme toggle script in the main HTML head.

SCSS and CSS enhancements:

• Introduced theme variables in _theme-variables.scss and imported them into the main stylesheet, enabling consistent color management for both themes. [1] [2]
• Added dark mode-specific styles in _dark-mode.scss to ensure all components and markdown content are visually coherent in dark mode, including overrides for third-party markdown CSS and icon color switching.

Visual improvements for theme-specific assets:

• Updated the Netlify badge in the footer to show the appropriate badge for the current theme, toggling between light and dark SVGs as needed. [1] [2]

Version bump:

• Updated package.json and package-lock.json to version 1.1.0 to reflect the addition of theme support. [1] [2]

Closes #607

[Jorgagu]

👋 @damianopetrungaro could you please review and give feedbacks on this PR ?

[Jorgagu]

👋 @lorenzodianni since you initiated the design and the new UI, could you please review this?

[lorenzodianni]

Hi @Jorgagu, thanks for the PR!
I think the right starting point is to continue following the core package github-markdown-css, which provides us with all the base styles. If we upgrade it to the latest version, the package already includes built-in light/dark mode support. On top of that, we can customize colors and styles as needed.

In my opinion, if we move forward with this restyle without upgrading the package, we’ll have significant technical debt in the near future.

@damianopetrungaro what do you think?

[Jorgagu]

@lorenzodianni If you’d like, I can upgrade the github-markdown-css package in a new branch (and PR) to test the behavior, then rebase this branch afterward to finish the work if needed.

[Jorgagu]

@lorenzodianni any updates ?