Skip to content

Commit 779e450

Browse files
Vinod KumarVinod Kumar
authored andcommitted
Updated Docs
1 parent 9ae7133 commit 779e450

File tree

6 files changed

+27
-15
lines changed

6 files changed

+27
-15
lines changed

docs/atomic-design.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
id: atomic-design
3+
title: Atomic Design Driven
4+
---
5+
6+
Universal React generator has [Atomic Design Philosophy](https://atomicdesign.bradfrost.com/chapter-2/) at its core. Apart from setting up Atomic scaffolding structure (Atoms, Molecules, Organism and Template) it brings along customizable npm packages [@xt-pagesource/generate-plop](/universal-react-docs/docs/generate-plop/) to create components, services and hooks on the fly.
7+
8+
## Implementing Atomic Design
9+
10+
Atomic design is a mental modal, when applied correctly it can do wonders in developing applications with great speed, brings great design consistency and reusability. It pushes you to identify and capture repeatable patterns throughout the application in reusable components. These components in turn will help develop user journeys faster and consistently. Components should be created with [Single Responsibility](https://en.wikipedia.org/wiki/Single-responsibility_principle) in mind to achieve maximum reusability.

docs/generate-plop.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,7 @@
33

44
[![Generate-plop Introduction by Khushboo Kumari](https://s7.gifyu.com/images/Banner0395df38ffe0484140.jpg)](https://web.microsoftstream.com/video/4508e6c4-7434-4247-a3a4-3a65e47f9352 "Generate-plop Introduction by Khushboo Kumari")
55

6-
Generate-plop is a simple, scalable and fast component generator. It can help
7-
you to scaffold components, templates, hooks and pages simply by running few
8-
cli commands. Automating the component creation process makes really easy for
9-
the team to maintain consistency and saves good time.
6+
[@xt-pagesource/generate-plop](https://www.npmjs.com/package/@xt-pagesource/generate-plop) is a simple, extensible and scalable component generator. It can help you to scaffold components, templates, hooks and pages simply by running few cli commands. Automating the component creation process makes really easy for the team to maintain consistency and saves good time.
107

118
This tool will generate typescript files by default. However, we can generate
129
javascript files as well by passing --js in script command.

docs/how.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,17 @@ title: How it works?
66
There are 2 Key Pillars of Universal React.
77

88
## 1. Instant initial setup
9-
109
React developers can run `npx create-universal-react` generator for setting up Micro Frontend and/or SPA architecture with essential tooling instantly.
1110
## 2. On-demand addition of optional features
1211

1312
React developers can continuously improve their project by running `npx create-universal-react` generator again for adding optional features like mocking, end-to-end testing or even new projects to their evolving applications.
1413

1514
## Architecture Overview
16-
1715
Using this generator you can setup and evolve a project into a combination of following architecture types.
1816

1917
![Architecture Types with Universal React generator](/img/universal-react-arch-types-2x.png)
2018

2119
### How does Universal React achieve Micro Frontend?
22-
23-
24-
25-
2620
There are 2 ways you can achieve Micro Frontend in this ecosystem.
2721

2822
1. **Micro-App Loader**: A small NPM package to load any React micro app or Web Component into a given container. Learn more [here](/universal-react-docs/docs/loader/).

docs/intro.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ title: Universal React
55

66
[![Forks](https://img.shields.io/github/forks/pagesource/universal-react-v2)](https://img.shields.io/github/forks/pagesource/universal-react-v2) [![Stars](https://img.shields.io/github/stars/pagesource/universal-react-v2)](https://img.shields.io/github/stars/pagesource/universal-react-v2) [![License](https://img.shields.io/github/license/pagesource/universal-react-v2)](https://img.shields.io/github/license/pagesource/universal-react-v2)
77

8-
An accelerator for setting-up scalable frontend architecture with Next.js and React.
8+
An accelerator for setting-up scalable frontend architecture with React and Next.js.
99

10-
This accelerator is a command line tool for generating SSR, SSG & Micro-App type of applications. This enables you to setup a working Micro Frontend or SPA development ecosystem with essential tooling for great dev experience and delivery quality.
10+
This accelerator is a command line tool for generating SSR, SSG & Micro-App type of applications. This enables you to setup a full-fledged Micro Frontend development ecosystem with essential tooling for great dev experience and delivery quality.
1111

1212
This will help project teams in building applications with great quality, by giving them more time to focus on business problems rather than web development chores.
1313

@@ -25,7 +25,7 @@ Following flow chart explains the workings of generator.
2525

2626
![Execution flow of Universal React generator](/img/universal-react-generator-2x.png)
2727

28-
## CLI walk-through
28+
## CLI walk through
2929

3030
[![CLI Generator Features by Rakesh Kumar 10](https://s7.gifyu.com/images/Banner018d3b1cbb27ffe53f.jpg)](https://web.microsoftstream.com/video/3b7ca6eb-d0ac-47e9-819b-d3e5e398ba09 "CLI Generator Features by Rakesh Kumar 10")
3131

docs/storybook.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,4 +11,15 @@ Storybook setup is equipped with important add-ons to test for A11Y as well.
1111
## Commands
1212

1313
- Start `yarn storybook`
14-
- Build `yarn build-storybook`
14+
- Build `yarn build-storybook`
15+
16+
## Configured Addons
17+
Storybook is configured with great addons for setting up an ideal dev ecosystem.
18+
19+
- @storybook/addon-a11y: Validate accessability for each component.
20+
- @storybook/addon-actions: Actions can be used to display data received by event handlers
21+
- @storybook/addon-docs: Document Stories in Storybook easily.
22+
- @storybook/addon-knobs: Change prop values and test components variations.
23+
- @storybook/addon-links: Create links that navigate between stories in Storybook.
24+
- storybook-design-token: Browse project design tokens in storybook.
25+
- @storybook/addon-viewport: Test component in various viewport.

sidebars.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
module.exports = {
22
someSidebar: {
33
Introduction: ['intro', 'features', 'why', 'how', 'road-map', 'contribution', 'adoption', 'support'],
4-
Features: ['monorepo', 'smart-context', 'design-system', 'loader', 'logger', 'generate-plop', 'module-federation', 'storybook', 'quality-control', 'unit-testing' ],
4+
Features: ['monorepo', 'smart-context', 'design-system', 'atomic-design', 'loader', 'logger', 'generate-plop', 'module-federation', 'storybook', 'quality-control', 'unit-testing' ],
55
},
66
};

0 commit comments

Comments
 (0)