Welcome to the documentation for ReferralNetworkHub! This document provides an overview of the project structure, setup instructions, and usage guidelines.
The ReferralNetworkHub project follows a typical directory structure for a Node.js and React.js application. Here's an outline of the main directories and their purposes:
- backend: Contains the backend code written in Node.js with Express. Includes API endpoints, middleware, and database configurations.
- frontend: Contains the frontend code written in React.js. Includes components, stylesheets, and other client-side assets.
- Documentation: Contains project documentation, including README files, contribution guidelines, and code of conduct.
- tests: Contains unit tests and integration tests for both backend and frontend code.
- public: Contains static assets served by the frontend application, such as images and favicon.
- LICENSE: The license file specifying the project's open-source license.
- README.md: The main README file providing an overview of the project.
- CONTRIBUTING.md: Guidelines for contributing to the project.
To set up ReferralNetworkHub locally for development or testing purposes, follow these steps:
-
Clone the repository to your local machine:
git clone https://github.com/your-username/ReferralNetworkHub.git
-
Navigate to the project directory:
cd ReferralNetworkHub
-
Install dependencies for both backend and frontend:
cd backend npm install cd ../frontend npm install
-
Create
.env
files in both thefrontend
andbackend
folders:- Copy the content from
.env.txt
to the newly created.env
files in each folder. Do not make any changes to the content.
- Copy the content from
-
Set up the MongoDB database:
- Install MongoDB locally or use a cloud-based service like MongoDB Atlas.
- Update the database connection URL in the backend configuration files.
-
Start the backend server:
cd ../backend npm run dev
-
Start the frontend development server:
cd ../frontend npm start
-
Access the application in your web browser at
http://localhost:3000
.
ReferralNetworkHub provides the following features and functionalities for users:
- User registration and authentication: Users can sign up for an account and log in securely.
- Job listings: Users can view available job listings with detailed information.
- Referral tracking: Users can track the status of referrals they've made and manage them accordingly.
- Communication features: Users can communicate with referrers and candidates through messaging.
Please refer to the README file in the project root for an overview of the project and its features.
For detailed API documentation and frontend component documentation, please refer to the respective directories in this documentation folder.
If you encounter any issues or have any questions, please refer to the contribution guidelines for information on how to get help or report problems.