Applio Websites (Monorepo)

Welcome to the Applio websites official monorepo! This README outlines the rules and guidelines for contributing to the monorepo, which is managed using Turborepo. Please read through this document carefully to ensure a smooth and efficient development process.

General Rules

Monorepo Structure
- The monorepo contains multiple projects. Each project is located in its respective directory under the apps directory.
Code Review
- All changes must go through a code review process. Open a Pull Request (PR) to the main branch when your feature or bugfix is complete.
- PR titles should follow the format: [Project] Short description of the change.
- Provide a detailed description of the changes in the PR, including the problem being solved and any relevant context.

Commit Message Guidelines

Format

Use the following format for commit messages:

[project]: Short description of the change

Detailed explanation (if necessary)

Example:

docs: Add new section to documentation

The new section includes detailed instructions on setting up the development environment. Adjusted the formatting to ensure consistency.

Scope
- Clearly specify the project you are contributing to by using the project identifier (e.g., applio-docs, applio-org, etc).
- If the change affects multiple projects, list all relevant project identifiers.
Message Content
- The short description should be concise yet descriptive.
- The detailed explanation should provide additional context, if necessary, including the reasoning behind the change and any potential impacts.

Turborepo Usage

Running Tasks
- Use Turborepo to run tasks across projects efficiently.
- Common tasks include:
  - pnpm run build to build all projects.
  - pnpm run lint to lint all projects.
  - pnpm run test to test all projects.
Project-specific Commands
- You can run tasks for specific projects by using the project identifier:
  - pnpm run build --filter=applio-docs
  - pnpm run test --filter=applio-org

Contribution Workflow

Cloning the Repository

Clone the monorepo to your local machine:

git clone https://github.com/IAHispano/Applio-Website.git
cd Applio-Website

Setting Up the Environment
- Install dependencies using pnpm:
```
pnpm install
```
Creating a New Branch
- Create a new branch for your feature or bugfix:
```
git checkout -b feature/applio-docs-new-section
```
Making Changes
- Make your changes in the appropriate project directory (apps/applio-docs, apps/applio-org, apps/applio-tv).
- Commit your changes following the commit message guidelines.
Pushing Changes and Creating a PR
- Push your branch to the remote repository:
```
git push origin feature/applio-docs-new-section
```
- Create a PR on GitHub and request a review from your team members.
Merging
- Once your PR is approved and all checks pass, you can merge it into the main branch.

Running Project-specific Commands

To run specific commands for a project (e.g., applio-docs), use the following:
```
pnpm i --filter=applio-docs
pnpm run dev --filter=applio-docs
```

Best Practices

Write clean, maintainable, and well-documented code.
Follow the coding standards and guidelines specific to each project.
Ensure all tests pass before submitting a PR.
Regularly pull the latest changes from the main branch to keep your branch up-to-date.
Participate in code reviews by providing constructive feedback to your peers.

Example Project Commands

To set up and run the documentation project (applio-docs):

Clone the repository:

git clone https://github.com/IAHispano/Applio-Website
cd Applio-Website

Install dependencies for applio-docs:
```
pnpm i --filter=applio-docs
```
Run the development server for applio-docs:
```
pnpm run dev --filter=applio-docs
```

Contact

If you have any questions or need further assistance, feel free to reach out to the repository maintainers or open an issue on GitHub.

Thank you for contributing to the Applio websites monorepo! Your efforts help us build amazing products.

Vidalnt/Applio-Website