Skip to content

jessicarobins/bulma-native

Repository files navigation

Bulma Native

Bulma Native is a React Native port of the amazing CSS component library, Bulma.

Getting started

This guide will help you start using Bulma Native components in your React Native app.

If you have not already set up a React Native project, please refer to the React Native documentation to get started. Bulma Native will work with both Expo and vanilla React Native projects.

Install

yarn add @jrobins/bulma-native

Installing Icons

If you would like to use components that include icons, and you are not using Expo, you will also need to add React Native Vector Icons and follow its installation instructions.

If you are using Expo, Icons are already built in via the @expo/vector-icons library.

For more information on icon installation and usage, see the Bulma Native Storybook page for Icons

Documentation

Documentation for the Bulma Native component library lives in the Bulma Native Storybook. There, you can preview components, view and interactively set their props, and copy sample code. This Storybook also contains information on setting up theming.

Caveat

The components in this Storybook were adapted to web using React Native Web. As such, components are not guaranteed to be 100% accurate reflection of what they would look like on a device.

Sub-caveat

The Image component relies on a prop specific to React Native. As such, it does not display on web. I am currently working on a solution for this, as well as a solution for previewing components using Expo Snacks.