l-min-components 1.0.520 → 1.0.523
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +111 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
|
|
2
|
+
# Learngual Components
|
|
3
|
+
|
|
4
|
+
This is the Components repository of the Learngual suite. It houses all the shared UI components that are used across various applications within the Learngual platform. All other applications depend on these components, ensuring a consistent look and feel as well as code reusability.
|
|
5
|
+
|
|
6
|
+
## Technologies and Libraries
|
|
7
|
+
This project is built using a range of modern technologies and libraries, including:
|
|
8
|
+
|
|
9
|
+
- **React:** A JavaScript library for building user interfaces.
|
|
10
|
+
- **Vite:** A modern frontend build tool.
|
|
11
|
+
- **Styled Components:** For component-level styling in React.
|
|
12
|
+
|
|
13
|
+
These are some of the key technologies that provide the foundation for our web application. For a full list of all the packages used, please refer to the `package.json` file in the project repository.
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
### Prerequisites
|
|
18
|
+
Before you begin, ensure you have the following installed:
|
|
19
|
+
- Node.js (Preferably the latest stable version)
|
|
20
|
+
- npm (Node Package Manager), which comes with Node.js
|
|
21
|
+
- Yarn (Optional, can be installed via npm with `npm install --global yarn`)
|
|
22
|
+
|
|
23
|
+
You can check your Node.js, npm, and Yarn version by running:
|
|
24
|
+
```
|
|
25
|
+
node -v
|
|
26
|
+
npm -v
|
|
27
|
+
yarn -v
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Step-by-Step Installation
|
|
31
|
+
|
|
32
|
+
1. **Clone the Repository**
|
|
33
|
+
- Clone the application repository to your local machine using the following Git command:
|
|
34
|
+
```
|
|
35
|
+
git clone https://github.com/Learngual-Inc/components.git
|
|
36
|
+
```
|
|
37
|
+
- After cloning, navigate into the project directory:
|
|
38
|
+
```
|
|
39
|
+
cd components
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
2. **Install Dependencies**
|
|
43
|
+
- Using npm:
|
|
44
|
+
```
|
|
45
|
+
npm install
|
|
46
|
+
```
|
|
47
|
+
- Or, using Yarn:
|
|
48
|
+
```
|
|
49
|
+
yarn install
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
These commands read the `package.json` file and install all the dependencies listed under `dependencies` and `devDependencies`.
|
|
53
|
+
|
|
54
|
+
3. **Running the Application**
|
|
55
|
+
- Using npm:
|
|
56
|
+
```
|
|
57
|
+
npm run dev
|
|
58
|
+
```
|
|
59
|
+
- Or, using Yarn:
|
|
60
|
+
```
|
|
61
|
+
yarn dev
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Access the application by navigating to `http://localhost:5173` in your web browser.
|
|
65
|
+
|
|
66
|
+
### Notes
|
|
67
|
+
- The `scripts` section in `package.json` provides additional commands:
|
|
68
|
+
- Using npm: `npm run build` to build the application for production and `npm run preview` to preview the built application.
|
|
69
|
+
- Using Yarn: `yarn build` to build the application for production and `yarn preview` to preview the built application.
|
|
70
|
+
|
|
71
|
+
- If you encounter any issues during installation, ensure your Node.js, npm, and Yarn are updated to the latest versions and try re-running the installation commands.
|
|
72
|
+
|
|
73
|
+
## Features
|
|
74
|
+
The Components repository includes a variety of reusable UI components, such as:
|
|
75
|
+
|
|
76
|
+
- **Button:** Customizable buttons for various user interactions.
|
|
77
|
+
- **Dropdown:** Flexible dropdown menus for user selections.
|
|
78
|
+
- **Search Bar:** Intuitive search functionality for efficient data retrieval.
|
|
79
|
+
- **Loader:** Visual indicators for loading states and asynchronous operations.
|
|
80
|
+
- **And many more:** The repository contains a diverse range of other components, each designed with flexibility and reusability in mind, to cater to the diverse needs of the Learngual applications.
|
|
81
|
+
|
|
82
|
+
## Contributing
|
|
83
|
+
To contribute, please follow these guidelines:
|
|
84
|
+
|
|
85
|
+
1. **Create a New Branch for Each Feature:**
|
|
86
|
+
- For each new feature or fix you're working on, create a separate branch from the main branch. Name the branch something descriptive related to the feature or fix.
|
|
87
|
+
|
|
88
|
+
2. **Add Changes and Commit:**
|
|
89
|
+
- Make your changes in your feature branch. Once you're done, add your changes and make a commit with a descriptive message.
|
|
90
|
+
|
|
91
|
+
3. **Pull the Latest Changes from Main:**
|
|
92
|
+
- Before pushing your changes, pull the latest changes from the main branch to ensure compatibility.
|
|
93
|
+
|
|
94
|
+
4. **Push Your Changes:**
|
|
95
|
+
- Push your changes to the remote repository.
|
|
96
|
+
|
|
97
|
+
5. **Create a Pull Request:**
|
|
98
|
+
- Go to the GitHub repository page and create a pull request (PR) for your branch. Describe your changes and proposed modifications.
|
|
99
|
+
|
|
100
|
+
6. **Request a Review:**
|
|
101
|
+
- Invite the team lead or other designated reviewers to review your PR.
|
|
102
|
+
|
|
103
|
+
7. **Merging:**
|
|
104
|
+
- Only the team lead or authorized team members should merge the PR after a successful review.
|
|
105
|
+
|
|
106
|
+
Please adhere to the coding standards and guidelines of the project. If you're unsure about something, feel free to ask!
|
|
107
|
+
|
|
108
|
+
## License
|
|
109
|
+
This project is proprietary. All rights reserved. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited unless otherwise permitted by the project owners.
|
|
110
|
+
|
|
111
|
+
|