Clone project of a famous Q/A website for developers built using MySQL, Express, React, Node, Sequelize :globe_with_meridians:
As the name suggests, this project is a clone of a famous Q/A website for professional and enthusiast programmers built solely by me using a completely different stack.
This repo consists of the Frontend code of the project, the backend code is in Stackoverflow-Clone-Backend
React.js (with Redux)
SASS
and BOOTSTRAP
Node.js with Express.js Framework
MySQL with Sequelize
POSTMAN
There are two ways to setup the project: manually or using the Dockerfile. Read below for more details:
Open your local CLI -
mkdir Stackoverflow-Clone
cd Stackoverflow-Clone
Setup the backend code -
NOTE: For Frontend Developers, if they dont want to setup the Backend Code, they can skip the Step 2, and make sure they follow the optional step mentioned in Step 4
Create a .env
file and the format should be as given in .env.example
.
Clone the code & install the modules-
git clone https://github.com/Mayank0255/Stackoverflow-Clone-Backend.git
cd Stackoverflow-Clone-Backend
npm install
Open your MySQL Client -
CREATE DATABASE stack_overflow;
NOTE: Don't forget to keep the database name same in the .env
and here.
Run the index npm start
.
Open a new CLI terminal and goto the root Stackoverflow-Clone
folder you created in the first step.
Setup the Frontend code -
Clone the code & install the modules-
git clone https://github.com/Mayank0255/Stackoverflow-Clone-Frontend.git
cd Stackoverflow-Clone-Frontend
npm install
Run the client index npm start
.
OPTIONAL (Recommended For Frontend Developers): Can just change the path here to this https://stackoverflow-clone-backend.herokuapp.com
Now, it will hit PROD
Let me know if you are interested and would want me to assign it to you
The back-end has support for Docker. So if you want to run the back-end in a container, you need do:
Setup environment variables in .env
file. Note when you use Docker setup and run the database in localhost (host machine), you need to setup the environment variables for use correct IP of MySQL Database. Please, read here and here for more details.
Build the Docker image:
docker build -t stackoverflowclone .
Run the container. For example, if you want to run the container in a new terminal, you can do:
docker run -d -p 5000:5000 stackoverflowclone
The default port of api is 5000. After running the container, you can access the api by typing:
http://localhost:5000/api/<endpoint that you request - see next section>
Follow the steps properly (manual or Docker) and you are good to go.
Contributing.md
Video Last Updated on 7th March, 2022