Frequently Asked

Do I have to use React to use Minerva?

Nope! All Minerva components are designed to work outside of a react environment. You can use the rendered HTML as reference, or create an implementation of Minerva in a different language. Or, at it's heart Minerva is just styles. You can always include Minerva's baseline CSS in your project and build up from there.

Why use React at all?

We chose to use React because it allows us to build and test components more easily. The only react features we really use are JSX and reusable components. React also plays well with Storybook, a tool made for creating design systems and component libraries. React is also used in WordPress' Gutenberg editor, so using the same language makes integration easier and avoids adding another language to learn for new hires.

React combined with TypeScript allows the code to be a little more self-documenting, making it easier to understand how a component should behave under certain conditions and what type of information a component is designed to handle. Another bonus is that Minerva can be consumed as an NPM package if working on a JAMStack project.

What browsers does the framework support?

Minerva uses CSS features available as early as the versions below, and should work with any version newer than what is listed.

  • Chrome 105
  • Edge 105
  • Safari 15
  • Firefox 121
  • Opera 91
  • Samsung Internet 23

The notable web web features used by Minerva are css-custom-properties, css-logical-props, css-grid, and css-has

A component looks different between Minerva and the WordPress theme

This is likely due to an unresolvable conflict in how the component was implemented in WordPress as a Gutenberg block. This could be because WordPress implemented the block with different markup or the Gutenberg editor may have limitations that prevent a Minerva component from functioning the same.

Why are the same components not available between the WordPress Theme and Minerva?

Not all Minerva components were designed to be implemented in WordPress and exist either as development resources or intended to be used on more technical websites. Some blocks in the theme were developed by WordPress and do not have a Minerva equivalent.