Hacktoberfest-2023

Stockify-Inventory Management 2.0

A cloud-based inventory management tool to easily manage, track and search products at one place.

NOTE: aaj kuch toofani karte hai

View Site here »

Getting Started

• Ensure you have Node.js installed. You can verify this by typing the following command in your terminal.

node --version

If you get a response as shown below, you do have it installed, otherwise you can download it from here.

v18.18.2

• Fork the repository to create a copy of it on your GitHub account

• Clone the forked repository by running the code below in your terminal

git clone https://github.com/[your-username]/inventory-management2.0.git

NB:

• Replace [your-username] with your GitHub username.
• Also, if you changed the name of the repository, remember to change it in the url.

• Install project dependencies by running the following command in your terminal from the root directory of the project.

npm install

• Setup a MongoDB database (you can use mongodb compass, mongodb shell or mongodb community server)

• Take note of the connection string of the database.

# example
mongodb://localhost:27017/inventory-management
# or
mongodb+srv://localhost/inventory-management
# where `inventory-management` is the name of your database

• Create a .env.local file in the root directory of the project with the following environment variables.

JWT_SECRET=topSecret
MONGODB_URL=mongodb://localhost:27017/inventory-management

• JWT_SECRET is a string to be used for encrypting and decrypting JWT tokens.

• MONGODB_URL is the connection string for the database created earlier.

• Spin up the development server by running command below

npm run dev

• The application should start on http://localhost:3000.

You are all set to rock!

Contribution Guide

Contributions are what make the open source community an amazing place to learn new things, come up with innovate ideas and solutions to problems, and develop skills and abilities. Any contributions you make are greatly appreciated.

Feel free to open an issue to discuss it, or directly create a pull request with necessary changes.

Making Your First Contribution

1. Setup the project locally.

   Head over to the Get Started if you are yet to do this.

2. Create a branch with a descriptive name highlighting the changes you intend to add.

   • Supposing you want to add code of conduct file, code-of-conduct could be your branch name. You can create a code-of-conduct branch by running the command below:

   git checkout -b code-of-conduct

3. Add the code-of-conduct.md file (or whatever changes you want to make).

4. Add your changes to git.

git add .

4. Commit your changes

git commit -m "Add code-of-conduct.md file"

5. Push changes to your GitHub repository

If this is your first time pushing changes to your repository from your current branch (code-of-conduct), run the following command:

git push --set-upstream origin code-of-conduct

else run the following in your terminal

git push

6. Create a new Pull Request on GitHub.

Making Another Contribution

1. Switch to the main branch

git switch main

2. Add a remote for the original repository (if you haven't already).

git remote add upstream https://github.com/codewithsonyy/inventory-management2.0.git

3. Pull the latest data unto your local repository

git pull upstream main

4. Push the new changes, if any, to your forked repository

 git push origin main

5. Repeat steps 2 - 6 of the previous section

Contributors

MENTOR

This project is inspired by YouTuber codewithharry

LICENSE