Merge pull request #50 from edx/ari/differentiated-builds

feat(build): static and themeable production builds

.eslintignore

@@ -1,3 +1,4 @@
 coverage/*
-dist
 node_modules
+static
+themeable

.eslintrc.json

@@ -1,5 +1,5 @@
 {
-  "extends": ["eslint-config-airbnb", "eslint-config-edx"],
+  "extends": ["eslint-config-edx"],
   "parserOptions": {
     "ecmaFeatures": {
       "jsx": true
@@ -9,7 +9,11 @@
     "react/no-array-index-key": "off"
   },
   "settings": {
-    "import/resolver": "webpack"
+    "import/resolver": {
+      "node": {
+        "extensions": [".js", ".jsx"]
+      }
+    }
   },
   "env": {
     "jest": true

.gitignore

@@ -4,3 +4,5 @@ node_modules
 npm-debug.log
 coverage
 jest*
+static
+themeable

.storybook/webpack.config.js

@@ -22,7 +22,7 @@ module.exports = {
             loader: 'css-loader',
             options: {
               modules: true,
-              localIdentName: '[name]__[local]___[hash:base64:5]',
+              localIdentName: '[local]',
               sourceMap: true,
             },
           },

README.md

@@ -13,6 +13,34 @@ Paragon provides accessible React components for use within the Open edX platfor
 
 Components' markup, keyboard triggers, and behavior are based on the [WAI-ARIA 1.1 Authoring Practices](https://www.w3.org/TR/wai-aria-practices-1.1/). Components are styled with [Bootstrap 4](https://v4-alpha.getbootstrap.com/) via CSS Modules. Documentation/demo site is available at http://edx.github.io/paragon.
 
+## Usage
+
+Paragon requires React 16 or higher. To install Paragon into your project:
+
+```
+npm i --save @edx/paragon
+```
+
+Since Paragon is a React library, components must be rendered with React and ReactDOM. This doesn't mean the entire page has to be rendered with React. You can read up about rendering React into a page within the [official ReactDOM documentation](https://reactjs.org/docs/react-dom.html).
+
+### Component API
+
+API documentation for each component is available below:
+
+- (asInput)[src/asInput]
+- (Button)[src/Button]
+- (CheckBox)[src/CheckBox]
+- (Dropdown)[src/Dropdown]
+- (Hyperlink)[src/Hyperlink]
+- (InputSelect)[src/InputSelect]
+- (InputText)[src/InputText]
+- (Modal)[src/Modal]
+- (RadioButtonGroup)[src/RadioButtonGroup]
+- (StatusAlert)[src/StatusAlert]
+- (Table)[src/Table]
+- (Tabs)[src/Tabs]
+- (TextArea)[src/TextArea]
+
 ## Development
 
 First, clone the repo and install dependencies. You must be running Node 6 or newer.