@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:
yarn add styled-components
yarn add styled-breakpoints
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.