Eureka

Eureka is a component-based Drupal theme built with Single-directory components (SDC) and Vanilla CSS, providing a modern and flexible starting point for site owners to build scalable and efficient websites using the Archimedes site template and Drupal Canvas.

Getting started

To use Eureka, you can install it via Composer as a dependency of Archimedes. However, Eureka is designed to be tightly coupled to the site template rather than used as a standard contributed base theme, and you should not assume that future updates will be compatible if you make deep modifications.

For simple changes to fonts or colors, you can override the CSS files directly at your web root. If you need to perform more significant customizations, Eureka is ready to be converted into a custom theme:

1. Create a custom theme directory and copy the Eureka files:
1. mkdir -p web/themes/custom
2. cp -R web/themes/contrib/eureka web/themes/custom/eureka
2. Add the new custom theme to your repository:
1. git add web/themes/custom/eureka
3. Remove the contributed version via Composer:
1. composer remove drupal/eureka

Finally, clear Drupal's cache (via the UI or drush cache:rebuild). This theme is now yours to customize as you see fit!

Sub-theming

Do not create your custom theme as a sub-theme of Eureka. Eureka does not provide backwards compatibility for sub-theming. This allows the theme to rapidly innovate and improve alongside the Archimedes template. If you create a sub-theme of Eureka, it is likely to break in future updates.

For more technical information about how to build a custom theme based on Mercury, see the project README.

Getting help

If you have trouble or questions, please visit the issue queue.

Roadmap

Eureka is under active development. Current focus is on bug fixes, performance improvements, and initial release stability. If you want to contribute, check out the issue queue.