reactive-bulma 2.3.0 → 2.4.0

Sign up to get free protection for your applications and to get access to all the features.
package/README.md CHANGED
@@ -128,6 +128,10 @@ In case you have cloned the repo, it will show you the following folders:
128
128
  - `atoms` (from `v1.0.0`).
129
129
  - `molecules` (from `v2.0.0`).
130
130
  - `organisms` (from `v3.0.0`).
131
+ - `design`: Location of common design tokens (coded on `.mdx` files) which are displayed above components sections in storybook's instance.
132
+ - `functions`: Dedicated to parsers and helper functions for repetitive logic.
133
+ - `interfaces`: Dedicated to interfaces used in components and functions typing.
134
+ - `types`: Dedicated to Bulma's style type setting (which are part of component's properties).
131
135
 
132
136
  ## Documentation
133
137
 
@@ -135,12 +139,23 @@ Reactive bulma's documentation, included in this repo in the root directory, is
135
139
 
136
140
  ### Running documentation locally
137
141
  - Go to `reactive-bulma` folder (where you cloned the repo before).
138
- - Run `npm install` to install the Node.js dependencies, including Storybook (the site builder).
142
+ - Open a console and run `npm install` to install the Node.js dependencies, including Storybook (the site builder).
139
143
  - Run `npm start`.
140
144
  - Wait until a new tab opens with url <http://localhost:6006/> in your browser.
141
145
  - In case you want to initiate it on the background, you can run `npm run start:cli`.
142
146
 
143
- Learn more about using `Storybook` by reading its [documentation](https://storybook.js.org/docs/react/get-started/install).
147
+ Learn more about `Storybook` by reading its [documentation](https://storybook.js.org/docs/react/get-started/install).
148
+
149
+ ### How to create a template component
150
+
151
+ After some time, I understood that creating component files is a repetitive and time-consuming task, so I made issue [#180](https://github.com/NicolasOmar/reactive-bulma/issues/180) to implement a library called [Hygen](https://www.hygen.io), whose function is to provide a way to generate templates for generic files that can consume time at the long term. You can run the script by the following steps:
152
+
153
+ - Open a console and run `npm run create` in your console.
154
+ - An will assistant will appear asking about how your component will be named. You can answer with text separated with spaces (` `), underscores (`_`), or hyphens (`-`)
155
+ - Then, the assistant will ask in which folder you want to create it (based on its type following [Atomic Design hierarchy structure](https://atomicdesign.bradfrost.com/chapter-2/))
156
+ - At last, the script should create all base files to reduce time and focus on custom implementation.
157
+
158
+ Learn more about `Hygen` by reading its [documentation](https://www.hygen.io/docs/quick-start).
144
159
 
145
160
  ## Usage
146
161
 
@@ -152,7 +167,9 @@ const App = () => (
152
167
  <Button text="This is a test" />
153
168
  );
154
169
  ```
155
- To see all component's variants and its code snippets, go to [Documentation](#documentation) section
170
+ To see all component's variants and its code snippets, go to [Documentation](#documentation) section.
171
+
172
+ In case you want to create a custom component for your forked Reactive Bulma version, the easiest way is by running the creation script I made, which [instructions are here](#how-to-create-a-template-component).
156
173
 
157
174
  ## Versioning
158
175