Welcome to the official GitHub repository for hackrpi.com, the home of HackRPI's 10th annual hackathon, HackRPI X! Over the past decade, HackRPI has grown into one of the most prestigious hackathons, providing a platform for innovation, collaboration, and creativity. As we celebrate this milestone, we invite you to be a part of this journey.
We're thrilled to see the HackRPI community grow each year and are always on the lookout for fresh ideas and perspectives. Whether you're a seasoned developer, a design enthusiast, or someone who's just passionate about hackathons, there's a place for you here!
- Bug Fixes: Spot an issue? Feel free to submit a pull request.
- Feature Suggestions: Got an innovative idea for the website? Raise an issue, and let's discuss it!
- Design Improvements: If you're a design enthusiast, your insights can give the website a fresh and innovative look.
- Documentation: Help make our documentation clearer and more comprehensive for future contributors.
- Outreach: Share the website and gather feedback, helping us reach a broader audience.
- Connect with Us: Reach out to our organizing team on Discord and ask the technology team for tasks or any assistance.
Recommended Tools:
- Editor: Visual Studio Code
- GitHub Desktop: Download here
- Node: Download Node.js
Steps:
-
Clone the Repository:
- Using GitHub Desktop, choose
File
>Clone repository
and select the HackRPI repository. This will create a local copy on your machine.
- Using GitHub Desktop, choose
-
Create a New Branch:
- Once the repository is cloned, create a new branch in GitHub Desktop.
- For features, use the naming convention:
feature/your-feature-description
. - For bugs, use the naming convention:
bug/your-bug-description
.
-
Implement and Commit Changes:
- Make the necessary changes in your branch. Use Visual Studio Code or your preferred editor.
- Add comments!!
- Once done, commit your changes using GitHub Desktop.
-
Update with Main:
- Before pushing your changes, ensure you have the latest version of
main
. In GitHub Desktop, pull the latest changes from themain
branch and merge them into your branch.
- Before pushing your changes, ensure you have the latest version of
-
Test Your Changes:
- Ensure your design is responsive. Test on multiple screen sizes, including mobile. Employ best practices for responsive design.
-
Push and Create a Pull Request:
- Push your branch to GitHub using GitHub Desktop.
- Then, visit the repository on GitHub's website and create a pull request. Write a description of the changes in the comment, and paste any relevant images showcasing updates. Our team will review, provide feedback, or merge your changes.
- Navigate to your cloned repository
- Run
npm install
to install/update packages - Run
npm start
to start the app - Go to localhost:3000 or the port that is mentioned when the app starts up
- Enjoy the view! 😎 (and debug)