Coding Languages:
Tools & Frameworks:
Project Management Tools:
Drop a :star: on the GitHub repository.
Download Git (when you install Git, Git Bash also gets installed by default)
Download and install a code/ text editor.
Download Node Js and npm(Node package manager) (when you install Node, npm also gets installed by default)
Mongo DB community editition is free and a great software in order to work with MongoDB applications. Download Mongo DB community editition
Robo 3T is a desktop graphical user interface (GUI) for Mongo DB. It can help to skip running all the Mongo DB commands manually every time we want to access the data. Download Robo 3T (optional)
Clone the repository by running command
git clone https://github.com/<your user-name>/WordNook.git
in your git bash.
Run command cd WordNook
.
Run this command to install all dependencies for the project.
npm install
Adding secret key for JWT auth.
.env
file.
touch .env
.env
file
SECRET_KEY = AlphaVio
URL = mongodb://localhost:27017/wordnookDB
NODE_ENV= 'development'
Testing : Run this command on your terminal/ bash to start the Mongo server on port 27017(default).
mongod
Run this command to start the project.
npm start
or
Run this command to start the project as a developer.
npm run dev
Open link to view the website in your browser window if it doesn't open automatically.
http://localhost:3000/
Download and install Docker.
Clone the repository by running command
git clone https://github.com/<your user-name>/WordNook.git
in your git bash.
Run command cd WordNook
.
Run this command to start the project:
docker-compose up --build
Now explore the project and make the changes as you want. Once the changes are made then run the following command again:
docker-compose up --build
This would again create a new image with your changes and will use it to start the containers. Now when you visit http://localhost:3000/
you would see your changes.
Once you are satisfied and want to make a PR then run following command:
docker-compose down
This would stop all the running containers and will also delete them.
Check out our docker image at DockerHub: Wordnook Image or you can directly search wordnook
on DockerHub (This just for your reference and is not required for installation)
You can learn more about Docker and its implementation at Docker Documentation
You can learn more about EJS template engine and its syntax to know how we can use it inside our HTML using the documentation
Now you are all set to use this project.
show dbs
use db <db name>
show collections
<db name> .find()
If your git shows an issue with your package-lock.json
while installing dependencies or throws error that lockfile version-2 is not compatible with your system
Then check your npm version by running command
npm --version
npm version should be 7 and above for lockfile version-2 that would come by default if you have a node version 15 and above.
List of Node.js releases and corresponding npm versions
After upgrading your npm version, you can delete your package-lock.json
file and run npm install
again to fix the issue.
The Contact Us
feature might not work in the local environment since the API-Key has not been shared. If you still want to work on it, generate your own API key from Mail Gun and include it in the .env
file as
MAILGUN_API_KEY = <your-api-key>
1. JGEC Winter of Code
2. Mexili Winter of Code
3. GirlScript Summer of Code
4. PClub Summer of Code
5. Let's Grow More Summer of Code
6. Developer Days
Pranav Mendiratta 💻📖 🚧 |
Ananya Negi 💻 📖 🚧 |
Rushan Khan 💻 📖 🚧 |
Pranav Singh 💻📖 🚧 |
Ayush Jain 💻 📖 🚧 |
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!