Campus Space is a MERN stack project with TypeScript & Tailwind CSS. Admins manage timetables, teacher absences, & rooms. Students & teachers view timetables, vacant rooms, & teacher absences. Teachers can book rooms for classes. Efficient college resource management.
- Tech Stack
- Contributing
- Setting Up on your machine
- Usage
- Resources for Beginners
- Documentation
- Code Reviews
- Feature Requests
- Spreading the Word
- MongoDB
- Express
- React
- Node. js
- Tailwind CSS
- TypeScript
Raise and issue; Get assigned and then work on fixing the issue. We welcome contributions to Campus-Space! Follow these steps to contribute:
-
Fork the Repository: Create your own copy of the repository on your GitHub account.
-
Clone the Repository : Clone the repository for making commits.
git clone https://github.com/your-username/Campus-Space.git
- Create a New Branch for your feature or bug fix: Make a separate branch to work on specific features or fixes and switch to the correct branch.
git checkout -b <new-branch-name>
- Make Changes and commit them: Implement your changes and save them with a descriptive commit message.
git add .
git commit -m "Describe your changes"
- Push Your Changes to your fork: Upload your committed changes to your GitHub fork.
git push origin <branch_name>
- Create a Pull Request ✅: Propose your changes to be merged into the original repository.
- Always work on a new branch for each issue or feature.
- Keep your branch up to date with the main repository's master branch.
- Write clear and descriptive commit messages.
- Test your changes thoroughly before submitting a pull request.
- Go to the project's issues section.
- Select the appropriate template for your issue.
- Provide a detailed description of the issue.
- Wait for the issue to be assigned before starting to work on it.
- Ensure that you have self reviewed your code.
- Make sure you have added the proper description for the functionality of the code.
- I have commented my code, particularly in hard-to-understand areas.
- Add screenshot it help in review.
- Submit your PR by giving the necesarry information in PR template and hang tight we will review it really soon.
Follow these steps to set up the project locally:
Clone the project
git clone https://github.com/sethshivam11/campus-space.git
Go to the project directory
cd campus-space
Install dependencies
npm run build
Start the server
npm run start
To run this project, you will need to add the following environment variables to your .env file
MONGODB_URI
PORT
ACCESS_TOKEN_SECRET
NODE_ENV
- Click Here for Server Side .env.sample file.
If you want to change the name of the college, image or footer links edit the env.production file in the client folder
VITE_COLLEGE_NAME
VITE_TWITTER
VITE_GITHUB
VITE_LINKEDIN
VITE_LOGO
- Click Here for Client Side .env.sample file.
2. You can get all the details about vacant rooms, Your timetable, Teachers absent, list of classes available at a particular period of time
Contributions are welcome!. You can suggest features to add, report any possible bug that might crept in, ideas and changes! 🚀
- Forking a Repo
- Cloning a Repo
- Creating a Pull Request
- Getting Started with Git and GitHub
- Learn GitHub from Scratch
- Document any significant changes or additions to the codebase.
- Provide clear explanations of the functionality, usage, and any relevant considerations.
- Be open to feedback and constructive criticism from other contributors.
- Participate in code reviews by reviewing and providing feedback.
- Suggest new features or improvements that would enhance the project.
- Share your experience and the project with others.
- Spread the word about the project on social media, developer forums, or any relevant community platforms.
Thank you for contributing to Campus-Space! Together, we can make a significant impact. Happy coding! 🚀