Welcome, and thank you for your interest in contributing to Ayurveda GPT, a React Web Application! We’re excited to have you participate in Hacktoberfest 2024! This guide will walk you through how to contribute and the guidelines to follow.
We welcome contributions! If you have suggestions to enhance the website or fix existing issues, please feel free to open an issue or submit a pull request.
Please attach a screenshot or video showcasing the feature or bug fix you have implemented when submitting your pull request to help us review your contribution more effectively.
- Navigate to the repository on GitHub:
https://github.com/MUDITJAINN/Ayurveda-GPT
. - Click the Fork button at the top right to create a personal copy of the repository.
Once you've forked the repository, clone it to your local machine:
git clone https://github.com/YOUR-USERNAME/ayurveda-gpt.git
Navigate into the project directory:
cd ayurveda-gpt
-
Install dependencies:
Make sure you have Node.js installed. Then, run:
npm install
-
Start the development server:
npm start
This will run the project locally at
http://localhost:3000
.
We welcome all types of contributions, whether it's a bug fix, feature suggestion, or documentation improvement. Here’s how you can get started:
- Click the Fork button at the top right of the repository page to create your own copy.
Clone the forked repository to your local machine:
git clone https://github.com/YOUR-USERNAME/ayurveda-gpt.git
Navigate into the project directory:
cd ayurveda-gpt
Create a new branch where you’ll work on your contribution:
git checkout -b your-branch-name
For example, if you’re fixing an issue, you could name your branch fix/issue-name
.
Find an issue from the Issues tab labeled hacktoberfest
, good first issue
, or help wanted
. Comment on the issue to indicate that you are working on it.
After making your changes, stage the files and commit them:
git add .
git commit -m "Detailed description of your changes"
Example: Fix: Resolved issue with missing alt attributes in images.
Once your changes are committed, push your branch to your forked repository:
git push origin your-branch-name
Go to the original repository and click New Pull Request. Provide a detailed description of your changes.
Wait for the maintainers to review your pull request. If everything looks good, it will be merged. If changes are required, the maintainers will provide feedback.
- Use concise and descriptive commit messages.
- Example:
Add feature for Ayurveda herbs list
.
- Make sure all tests pass (if applicable).
- Follow the project’s code style and naming conventions.
- Provide a clear and concise description in the pull request.
- Follow React best practices.
- Write clean, modular, and reusable code.
- Use descriptive variable and function names.
- Components should be as small and simple as possible.
- Use
let
andconst
instead ofvar
.
The project is built using the following technologies:
- React.js: JavaScript library for building user interfaces
- HTML5 & CSS3: Structuring and styling the web pages
- JavaScript (ES6+): Modern JavaScript features and syntax
- Bootstrap/Tailwind CSS: For responsive design and styling
- Node.js: Runtime environment for executing JavaScript on the server
- Express.js: Lightweight web framework for Node.js
- MongoDB: NoSQL database for storing user data and content
- OpenAI GPT-3 API: For generating personalized Ayurvedic responses
- JWT (JSON Web Token): For secure user authentication
- Netlify: For frontend hosting
- Heroku/Render: For backend hosting
If you find this project useful or interesting, please star the repository! Your support helps motivate the development of new features and improvements.
Please adhere to our Code of Conduct to create a positive, inclusive, and respectful environment for everyone involved.
We’re thrilled to have you contribute to the Ayurveda GPT project! Whether you’re fixing bugs, adding features, or improving documentation, your contribution is valuable and appreciated. Thank you for making this project better!