@logrock/pebbles

@LogRock/Pebbles

Welcome to our Component Library! This is an implementation of our Asphalt Design System.

Here are some useful links:

Documentation/Storybook

NPMJS registry

About us: https://logrock.com

Using this library:

This library is meant to be used in React projects. To use it, you will have to setup your prefered React environment and add a few other dependencies first:

# styled components
yarn add styled-components
yarn add styled-breakpoints

# fonts
yarn add @fontsource/archivo

Make the Archivo font available in your project by importing it

import "@fontsource/archivo/400.css";
import "@fontsource/archivo/500.css";
import "@fontsource/archivo/600.css";
import "@fontsource/archivo/700.css";
import "@fontsource/archivo/800.css";

You can, alternatively, make it available as a Variable font if you want. The only requirement is having all weights from 400 to 800 available for the default theme to work best.

If you customize the theme by changing any of the fontFamily properties, make sure that the font you want to use is also made available, by exposing it in any ways you like (fontsource is the best!)

Install this lib:

yarn add @logrock/pebbles

Now, wrap your app (or whatever components you plan on using this library at) with a styled-components' ThemeProvider, passing along a theme.

import { ThemeProvider } from "styled-components";
import { lightTheme } from "@logrock/pebbles";

const MyApp = () => {
  return (
    <ThemeProvider theme={lightTheme}>
      <MyAppContent />
    </ThemeProvider>
  );
};

For your convenience, we currently provide a light and a dark theme that you can use and override as you see fit. Check out all it's options at theme.ts

We also expose a Theme type if you use Typescript, autocomplete at will!

import { Theme } from "@logrock/pebbles";

And you are all set! From now on, just import and use any components you want. You can also access the theme variables using styled-components' own ThemeContext anywhere (and also as a theme prop in your custom styled components)

Contributing

Thank you for your interest, check out CONTRIBUTING.md for more info.

Changelog

6.0.0 (2022-03-25)

Features

• added new loader ring component: loader ring substitutes old progress loader component (403aab5)

BREAKING CHANGES

• added new loader ring component: removed old ProgressLoader component