How everesh/wanikani-elementarydark works
Project type and purpose
• This is a SASS‐based theming project for the WaniKani website called “WaniKani-ElementaryDark.”
• It provides a drop-in dark theme by overriding native CSS variables and injecting compiled CSS into the site.
File structure
• Top-level files:
• make.sh – build script
• main.scss – master SASS entry point
• version – version stamp
• Directories:
• base/ – core SASS partials (variables, core styles, legacy fallbacks, overrides)
• pages/ – per-page style overrides
• themes/ – sample CSS theme variants (catppuccin, gruvbox, template)
Key README insights
• Maintainability and backwards compatibility by hijacking native CSS variables.
• Entirely rewritten in SASS for modularity.
a. SASS Modules
• base/variables.scss
• base/core.scss
• base/legacy.scss
• base/overrides.scss
• pages/*.scss
• themes/*.css (alternative manifests)
b. Build Process
• make.sh invokes SASS compiler on main.scss
• Outputs final CSS (e.g., dist/wanikani-elementarydark.css)
c. Integration Points
• Host website (WaniKani) supplying native CSS variables
• User’s browser or userscript loading the compiled CSS
Relationships & interactions
• main.scss imports base/variables → base/core → base/legacy → base/overrides → pages/*.scss
• make.sh drives SASS compilation, reads main.scss, produces a single CSS file
• Final CSS is injected into WaniKani website, overriding its native variables and selectors
Architectural patterns & principles
• Modular SASS partials (separation of concerns)
• Variable hijacking for backwards-compatibility
• Theme layering: core → overrides → page-specific → theme variants
Technologies & tools
• SASS/SCSS compiler
• POSIX shell (make.sh)
• WaniKani site CSS variables (external dependency)
• Git for versioning