This guide will walk you through the installation and setup of the Microcks Hub project. You'll learn how to set up the frontend and backend locally, as well as how to contribute to the project.
Before you begin, make sure you have the following installed:
- Node.js (v18.x or above) (Preferably, use Volta)
- npm (comes with Node.js)
- Docker (if you want to use Docker for setup)
- Git (for cloning the repository)
-
Fork the repository from Microcks Hub GitHub.
-
Clone the repository to your local machine:
git clone https://github.com/YOUR_USERNAME/hub.microcks.io.git cd hub.microcks.io
-
Navigate to the Backend Directory:
cd server -
Install Backend Dependencies:
npm install
-
Start the Backend Server:
npm run start
The backend server will start on http://localhost:4000.
-
Verify the Backend:
If everything is set up correctly, you should see the message:
Express server listening on port 4000 Connected to the in-memory SQLite database.
-
Navigate to the root Directory:
cd .. -
Install Frontend Dependencies:
npm install
-
Navigate to the react Directory:
cd react -
Start the Frontend Development Server:
npm run dev
The frontend will be available at http://localhost:4200.
Check out our CONTRIBUTING guide for details. All the best! 🚀