@opuscapita/react-showroom-client

    1.3.0-beta.10 • Public • Published

    OpusCapita Showroom

    CircleCI Status badge-npm-version badge-license NPM Downloads

    Synopsis

    Awesome react based components catalog which provides you with markdown documentation and live examples. 💥

    If you're interested in project development, please star it and send us your pull-requests!

    showroom-demo

    Live demos

    Start a new project in 2 minutes!

    Video

    We have preconfigured a project template with webpack, babel, tests, etc. (full overview)

    Install template generator globally

    npm install -g @opuscapita/react-showroom-template
    

    Create an empty directory

    mkdir my-react-project && cd my-react-project
    

    Init a project and ask several questions

    showroom init
    

    Install deps

    npm install
    

    Done 🌟 Let's run it!

    npm start
    

    Open in browser: http://localhost:3000


    You can easily add a new component.

    showroom add and specify component name

    Component will be added to src/client/components directory

    Component is a directory that includes:

    • <component_name>.DOCUMENTATION.md
    • <component_name>.react.js file with skeleton of component
    • <component_name>.less file with styles
    • index.js file with component export

    Add showroom to existing project

    See documentation here

    Need help with integration to your open-source project? Create an issue or contact us 😇

    See also

    Motivation to develop

    The fundamental ideas of ReactJS is modularity and code reuse. You shouldn't rewrite same things every time.

    What ReactJS creators say about it:

    How do you know what should be its own component? Just use the same techniques for deciding if you should create a new function or object. One such technique is the single responsibility principle, that is, a component should ideally only do one thing. If it ends up growing, it should be decomposed into smaller subcomponents.

    As you start to build large libraries of components, you'll appreciate this explicitness and modularity, and with code reuse, your lines of code will start to shrink. :)

    O.K., ReactJS creators 👍 We are sure you are clever. We understand your ideas. But if we want to have a large libraries of components we must have a easy way to organize and browse this library.

    • Facebook has thousands of components.

    • In contrast - now we have no common UI composable pieces which allows developers to construct complex business logic components fast with modern user interface for a better user experience. Happy customer => happy seller

    • Twitter Bootstrap/React Bootstrap don't solve the problem. It has a good looking typography and a simple for use grid system. It has only a little number of basic components like buttons and inputs.

      For example if you have a vertical split-screen, default bootstrap grid system based on html media-queries became useless. Media-queries reacts on main viewport size changes, but with split-screen we have two virtual viewports. Simple react component tracking size of specified DOMNode can solve the problem. If we can't find at http://npmjs.com we can write it themselves and reuse in future.

    • There are lots of good-written third-party components. But they can't cover all use-cases. The problem of most of them:

      Written by different people with a different methodology of development and styles organization (style conflicts are not a rarity)

      We can't change them when met a limitations of API

    Allen Carr The easy way to start organizing libraries:

    • Spent several hours/days creating a component? Spend 30 more minutes to put your component in a library and write simple documentation with a code example.
    • Next time you or your teammate won't have to rewrite it again.
    • Or you can spend several hours/days 🕙 to /dev/null again.
    • The choice is yours.
    • Take care about other developers and others take care about you 🎩

    Contributors

    Alexey Sergeev
    Kirill Volkovich

    Contributing is welcome. We need YOU! 🤘

    Contributing guide

    How to start

    npm start npm script of @opuscapita/react-showroom-client can confuse if you want to contribute to showroom. Use this npm goal only to start showroom in server variant.

    More preferred way is: run npm link, then npm run link-mode;

    Install showroom-template separately.

    Before running showroom-template's npm start run npm link @opuscapita/react-showroom-client. After that you can change showroom's source-code and see result.

    If you need more info about contribution - please create an issue.

    License

    OpusCapita Showroom is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

    Install

    npm i @opuscapita/react-showroom-client

    DownloadsWeekly Downloads

    75

    Version

    1.3.0-beta.10

    License

    Apache-2.0

    Unpacked Size

    2.24 MB

    Total Files

    5

    Last publish

    Collaborators

    • elaczapiewska
    • jarkko.rouvinen
    • bo-kh
    • pdetmer
    • janek.bug
    • alexeysergeev
    • ilkkalehtinen
    • havantkim
    • eriihine
    • tamkov-sc
    • kwierchris
    • elefantino
    • samikarj
    • dsanko
    • dmitrydivin
    • alexanderdanilov
    • egor.stambakio
    • jenni
    • ocmachineuser
    • lukaszkepa
    • naniantero
    • nkovalenko-sc
    • jluukka
    • zjuice
    • adam-dziomdziora-cybercom
    • kaputse
    • dmitriy.sanko
    • nczeranka
    • ocautomation
    • maciej-wakula-opuscapita