Documentation
Hellō Buttons

Hellō Buttons

This page provides details on add Hellō buttons to your web application.

Stylesheet

To style the Hellō button, including hover styles, add the Hellō stylesheet in the document's <head> section. This stylesheet is used when using HTML, React, Svelte, or Vue.

<head>
  <!-- ... -->
  <link href="https://cdn.hello.coop/css/hello-btn.css" rel="stylesheet"/>
</head>

Explorer

Explore the different styles available for Hellō buttons, then select the platform and copy the snippet to add to your application.

Style
Color
Theme IgnoreTheme Aware
Hover
State
light Mode
dark Mode
<button class="hello-btn">
  ō&nbsp;&nbsp;Continue with Hellō
</button>

CSS Reference

Here are the Hellō button style classes:

Button style classesDescription
.hello-btn-black-on-darkBlack button with dark borders for dark backgrounds
.hello-btn-black-and-invertDynamic black/gray button for light and dark themes
.hello-btn-black-and-staticBlack button with a dark border on dark theme, and without a border on a light theme
.hello-btn-white-on-lightWhite button with dark border for light and dark themes
.hello-btn-white-on-darkGray button for both light and dark themes
.hello-btn-white-and-invertDynamic white/black button with dark borders for light and dark themes
.hello-btn-white-and-staticWhite button with dark border on light theme, gray button on dark theme

Enhance user experience by adding interactive hover effects to your buttons.

Hover style classesDescription
.hello-btn-hover-glowSubtle glowing effect on hover
.hello-btn-hover-flareCaptivating flare effect when hovered over
.hello-btn-hover-noneNo hover effect applied

Clearly indicate when buttons are in a loading state with a spinner for a user-friendly experience.

Button state classesDescription
.hello-btn-loaderAdds a loading spinner respecting button style and hover classes

Script

The hello-btn.js script enables a tooltip and localization. To use those features, add the following <script/> to your document <head/>

<head>
  <!-- ... -->
  <link href="https://cdn.hello.coop/css/hello-btn.css" rel="stylesheet"/>
  <script src="https://cdn.hello.coop/js/hello-btn.js"></script>
</head>

Tooltip

To display a tooltip alongside the button and educate your users about Hellō, add the following:

<div class="hello-container">
  <button class="hello-btn"></button>
  <button class="hello-about"></button>
</div>

The script automatically adds the "ō Continue with Hellō" text to the button. If you wish to override this behavior, such as changing the button label to "ō Update Email with Hellō," you can do so with the data-label attribute.

<div class="hello-container">
  <button class="hello-btn" data-label="ō&nbsp;&nbsp;&nbsp;Update Email with Hellō"></button>
  <button class="hello-about"></button>
</div>

Locales

By default, the Hellō script localizes the button text according to the browser's language settings (window.navigator.language) if the locale is supported (opens in a new tab). However, you can override this behavior using the lang attribute:

<div class="hello-container" lang="es">
  <button class="hello-btn"></button>
  <button class="hello-about"></button>
</div>

To view the list of supported locales, please visit hellocoop/wallet-i18n (opens in a new tab).
Don't see your locale? We encourage you to create a translation for your locale following hellocoop/wallet-i18n (opens in a new tab) guidelines and submit a pull request for review.

Rolling your own

You can find the CSS and JS source code at hellocoop/button (opens in a new tab).

If you want to create your own styles, the Hellō button is either charcoal (#303030) on white, or white on charcoal. Note that the Hellō logo ō is an o with a macron. You can use the ō character if you have <meta charset="UTF-8"> in your page <head> element (best practice for HTML documents). For reference, the UTF-8 encoding is 0xC5 0x8D and the HTML markup is &omacr;.