Giter Site home page Giter Site logo

nessie's Introduction

Nessie

GitHub package version Nessie build status

React + CSS-Modules + Loads of tests = Robust components for monstrous UIs!

Usage

There are three dependencies you’ll need to include in your app to use Nessie:

  1. The Nessie JS,
  2. the Nessie CSS
  3. and the Nessie SVG sprite map

Since your exact requirements may vary, we’ll leave it up to you decide exactly how these should be implemented (the options are outlined below).

JS

Importing all components as Nessie.ComponentName

If you want everything:

import * as Nessie from 'nessie';

Importing individual components:

If you want specific components:

import { ComponentName } from 'nessie';

CSS

The Nessie CSS is bundled separately in dist/styles.css. You can either import this file using webpack css-loader or load it directly in your HTML.

Sprite map

In order to use the <Icon> component (and other components that make use of icons), you’ll need the Nessie SVG sprite map component.

There are two ways that you can implement this:

Including the raw sprite map your HTML

You can add /dist/sprite.html directly in your HTML. The method of doing this is up to you.

Using the SpriteMap component

The <SpriteMap> component can be inserted anywhere inside your <App> (e.g. as a direct child of the Nessie <Page> component).

However the preferred method is to add a second React mount point specifically for the sprite map. The pattern is:

<html>
    <head>
        ...
    </head>
    <body>
        <div id="root"></div>
        <div id="spriteMap"></div>
    </body>
</html>
ReactDOM.render( <App />, document.getElementById( 'root' ) );
ReactDOM.render( <SpriteMap />, document.getElementById( 'spriteMap' ) );

Component Reference

See the individual README.md files in each component folder.

Contributing

We gladly accept and review any pull requests. Feel free! ❤️

To get you started we’ve written a Nessie Dev Guide.

Code of Conduct

This project adheres to the Contributor Covenant. By participating, you are expected to honor this code.

Nessie - Code of Conduct

nessie's People

Contributors

eric-martinez-sociomantic avatar damian-rodriguez-sociomantic avatar conor-cafferkey-sociomantic avatar joppe-rhebergen-sociomantic avatar ericgraficode avatar josh-wilson-sociomantic avatar

Watchers

James Cloos avatar Darren Impey avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.