diff --git a/docs/lib/Home/index.js b/docs/lib/Home/index.js index 7c8124ec4..5c75697f6 100644 --- a/docs/lib/Home/index.js +++ b/docs/lib/Home/index.js @@ -8,100 +8,101 @@ const importBasic = require('!!raw-loader!../examples/import-basic'); export default () => { return ( -
- +
+ + + + +

+ +

+

reactstrap

+

+ Easy to use React Bootstrap 4 components +

+

+ + + +

+ +
+
+
- - -

- -

-

reactstrap

-

- Easy to use React Bootstrap 4 components -

-

- - -

- -
-
- - - - -

Installation

-
-

NPM

-

Install reactstrap and peer dependencies via NPM

-
+          
+            
+              

Installation

+
+

NPM

+

Install reactstrap and peer dependencies via NPM

+
               npm install --save reactstrap react react-dom
             
-

Import the components you need

-
- -
-
+              

Import the components you need

+
+ +
+
               
                 {importBasic}
               
             
-

Getting Started with Create React App

-

Follow the Create React App instructions and then follow the Adding Bootstrap instructions.

-

tl;dr

-
+              

Getting Started with Create React App

+

Follow the Create React App instructions and then follow the Adding Bootstrap instructions.

+

tl;dr

+
               
 {`npx create-react-app my-app
 cd my-app
 npm start`}
               
             
-

- Then open http://localhost:3000/ to see your app. The initial structure of your app is setup. Next, let's add reactstrap and bootstrap. -

-

Adding Bootstrap

-

Install reactstrap and Bootstrap from NPM. Reactstrap does not include Bootstrap CSS so this needs to be installed as well:

-
+              

+ Then open http://localhost:3000/ to see your app. The initial structure of your app is setup. Next, let's add reactstrap and bootstrap. +

+

Adding Bootstrap

+

Install reactstrap and Bootstrap from NPM. Reactstrap does not include Bootstrap CSS so this needs to be installed as well:

+
               
   {`npm install --save bootstrap
 npm install --save reactstrap react react-dom`}
               
             
-

Import Bootstrap CSS in the src/index.js file:

-
+              

Import Bootstrap CSS in the src/index.js file:

+
               import 'bootstrap/dist/css/bootstrap.min.css';
             
-

Import required reactstrap components within src/App.js file or your custom component files:

-
+              

Import required reactstrap components within src/App.js file or your custom component files:

+
               
                 {`import { Button } from 'reactstrap';`}
               
             
-

Now you are ready to use the imported reactstrap components within your component hierarchy defined in the render method. Here is an example App.js redone using reactstrap.

-

CDN

-

Reactstrap can be included directly in your application's bundle or excluded during compilation and linked directly to a CDN.

-
+              

Now you are ready to use the imported reactstrap components within your component hierarchy defined in the render method. Here is an example App.js redone using reactstrap.

+

CDN

+

Reactstrap can be included directly in your application's bundle or excluded during compilation and linked directly to a CDN.

+
               
                 https://cdnjs.cloudflare.com/ajax/libs/reactstrap/4.8.0/reactstrap.min.js
               
             
-
-

- Note: When using the external CDN library, be sure to include the required dependencies as necessary prior to the Reactstrap library: -

- -
-

Check out the demo here

-

About the Project

-
-

This library contains React Bootstrap 4 components that favor composition and control. The library does not depend on jQuery or Bootstrap javascript. However, https://popper.js.org/ via https://github.com/souporserious/react-popper is relied upon for advanced positioning of content like Tooltips, Popovers, and auto-flipping Dropdowns.

-

There are a few core concepts to understand in order to make the most out of this library.

-

1) Your content is expected to be composed via props.children rather than using named props to pass in Components.

-
+              
+

+ Note: When using the external CDN library, be sure to include the required dependencies as necessary prior to the Reactstrap library: +

+ +
+

Check out the demo here

+

About the Project

+
+

This library contains React Bootstrap 4 components that favor composition and control. The library does not depend on jQuery or Bootstrap javascript. However, https://popper.js.org/ via https://github.com/souporserious/react-popper is relied upon for advanced positioning of content like Tooltips, Popovers, and auto-flipping Dropdowns.

+

There are a few core concepts to understand in order to make the most out of this library.

+

1) Your content is expected to be composed via props.children rather than using named props to pass in Components.

+
               
 {`// Content passed in via props
 const Example = (props) => {
@@ -123,21 +124,21 @@ const PreferredExample = (props) => {
 }`}
               
             
-

- 2) Attributes in this library are used to pass in state, conveniently apply modifier classes, enable advanced functionality (like popperjs), or automatically include non-content based elements. -

-

Examples:

-
    -
  • isOpen - current state for items like dropdown, popover, tooltip
  • -
  • toggle - callback for toggling isOpen in the controlling component
  • -
  • color - applies color classes, ex: {'
  • -
  • size for controlling size classes. ex: {'
  • -
  • tag - customize component output by passing in an element name or Component
  • -
  • boolean based props (attributes) when possible for alternative style classes or sr-only content
  • -
- - - -
+

+ 2) Attributes in this library are used to pass in state, conveniently apply modifier classes, enable advanced functionality (like popperjs), or automatically include non-content based elements. +

+

Examples:

+ + + + +
); }; diff --git a/docs/lib/PremiumThemes/index.js b/docs/lib/PremiumThemes/index.js new file mode 100644 index 000000000..62a9f0532 --- /dev/null +++ b/docs/lib/PremiumThemes/index.js @@ -0,0 +1,55 @@ +import React from 'react'; +import { Card, Button, CardBody, CardHeader, Container, Row, Col, Jumbotron } from 'reactstrap'; + +export default () => { + return ( +
+ +

+ +

+

Reactstrap Themes & Templates

+

A collection of free and premium React templates and themes powered by Reactstrap

+
+ +

+ UiFort +

+

Check out some examples that our partners from UiFort created using the Reactstrap components library.

+ + + + +
+ + Bamburgh React Admin Dashboard with Reactstrap PRO + +
+

+ Premium React Admin Template +

+
+ + + + + +
+ + + +
+ More themes will be added soon ! +
+
+ +
+
+ +
+
+
+ ); +}; diff --git a/docs/lib/UI/Nav.js b/docs/lib/UI/Nav.js index 2759b47a0..06990a976 100644 --- a/docs/lib/UI/Nav.js +++ b/docs/lib/UI/Nav.js @@ -20,28 +20,31 @@ export default class UINav extends React.Component { } render() { return ( - - - reactstrap - - - - - - + + + reactstrap + + + + + + ); } } diff --git a/docs/lib/routes.js b/docs/lib/routes.js index b3ea7c0fb..28230a564 100644 --- a/docs/lib/routes.js +++ b/docs/lib/routes.js @@ -1,6 +1,7 @@ import React from 'react'; import { Route, IndexRoute, IndexRedirect } from 'react-router'; import Home from './Home'; +import PremiumThemes from './PremiumThemes'; import LayoutPage from './Components/LayoutPage'; import NavsPage from './Components/NavsPage'; import NavbarPage from './Components/NavbarPage'; @@ -37,46 +38,47 @@ import Utilities from './Utilities'; import UI from './UI'; const routes = ( - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - ); export default routes; diff --git a/docs/static/themes/bamburgh-react-admin-dashboard-reactstrap-pro.jpg b/docs/static/themes/bamburgh-react-admin-dashboard-reactstrap-pro.jpg new file mode 100644 index 000000000..fad6e644b Binary files /dev/null and b/docs/static/themes/bamburgh-react-admin-dashboard-reactstrap-pro.jpg differ