LHA Labs
Applications
This section presents the different public projects done LHA-Labs community
Donate
The project that hold the website and donation site for the Let's Help Association
Technologies Used
- Next.js
- Material-UI
- Formik + Yup
- React Query
- Axios
- Nx
Features
Repository Rules and Regulations
Introduction
This document outlines the rules and regulations for interacting with this repository. These rules are designed to maintain the integrity of our codebase and ensure a smooth development process.
Branch Functioning
All Branches are named following the better-branch syntax. You can read the documentation and install better-commits to access this and ease your creation of branches by typing better-branch
in the terminal.
For better referencing, branches can be prefixed with the project name. Example: lynkr_landing
Workflow
-
Accessing project Kanban space
- The project is organized in a public a kanban board.
- All pending tasks are to be listed in the backlog and associated to the corresponding project.
- If you have no assigned task, you can self assign a "ready" task and move it to the "In progress" column.
-
Creating Branches
After being assigned a task from the board,
- Before starting any work, checkout to the feature branch using the
better-branch
command.
- Your branch name should look like
docs/#5-setup-repository-readme
(to reference a documentation branch.)
-
Working on Tasks
- Developers should work on their assigned task feature branches.
- All commits must be done using "better-commits".
- Commit messages should be descriptive of the changes done in the corresponding files.
- Keeping commits as small as possible will ease you writting your commit message.
- Commits should be atomic, with each commit representing a single code change, facilitating review.
-
Pull Requests
- After completing a task, submit a pull request to the develop branch.
- Request a review from a relevant maintainer.
- Post a message in the group with a link to the pull request to campaign for review.
- Keep your PR's as small as possible enable swift and concise reviews.
- For beginners, wait for PR validation before moving on to the next task to ensure learning from feedback.
- Only branches named using the better-branch syntax will be validated during PR's
-
Validation and Merging
- The code owner need to be prompt in the updating of requested changes.
- Only maintainers have the right to validate and merge PRs into develop and main branches.
- Once merged, the owner can move unto the next task.
Setup
Windows / Linux
-
Clone the repository:
git clone https://github.com/LHA-Labs/lha-labs.git
-
Change to the project directory:
cd lha-labs
-
Install dependencies:
npm install
-
Create a .env
file by following the .env..skeleton template.
-
Start an application using Nx:
npx nx serve <app name>
Replace with the name of your specific application.
Contributing
- Contributions make the open source community such an amazing place to learn, inspire, and create.
- Any contributions you make are truly appreciated.
- Check out our contribution guidelines for more information.
Conclusion
These rules and regulations are in place to ensure the efficient and organized development of our projects. Adhering to these guidelines will help us maintain code quality, collaboration and a smooth development process.
Relevant Developer Resources
Connect with us!
To join the family of donors,