Skip to content

amanjagdev/stockify

Repository files navigation

Stockify


About the Project

Made for Atmanirbhar Bharat Hackathon

This was a project intended to make the life of Warehouse owners easy by providing them with a Dashboard with clean UI and simple interface where Warehouse owner can keep a track of all their current stocks present in the Warehouse and soon the option for normal user to find near vacant Warehouses to store stuff. We intend to include features like Graphical representation of stocks present and activity charts based on previous activities of stock addition and removal. As this a Web Based Application so warehouse owners can have all their data synced across their devices.

See Live

Stockify

Technologies Used

Made on MERN Stack

This app is deployed to Heroku.


Glimpse of UI

Stock Management

live

Home Page

WelcomePage

Login Page

Login Page

Your Warehouse

Warehouse

User Profile

Profile

Watch our video to understand better

https://youtu.be/02PT4QOo84w


Getting Started

Local installation guide:

The following section will take you through the steps of setting up this app and getting it running locally on your computer.

1. Clone the repository

The first step is to clone the project repository to a local directory on your computer. To clone the repository, run the following command:

git clone https://github.com/amanjagdev/stockify.git

2. Install Node.js

If you don't already have Node.js installed on your computer, you can install the latest version here.

3. Install yarn

To be able to install the dependencies and start the application locally, you will need to install yarn. Yarn is a package manager like npm. To install yarn, run the following command:

npm install -g yarn

For more information about yarn and other installation options, see the yarn documentation: https://yarnpkg.com/en/.

4. Install the project dependencies.

Version information for each of these packages is available in the package.json file in the project root directory and in the client directory.

After you clone the repository to a local directory, change directory to the project root directory and run the following command to install the required packages:

yarn install

5. Generate MongoDb Connection URI

Sign in here https://www.mongodb.com/cloud to generate your connection string.

Get your connection string from MongoDB Atlas by following these steps:

  1. In the Clusters view, click the Connect button for the cluster to which you want to connect.
  2. Choose Connect your application from the dialog box.
  3. Choose your driver as Nodejs and driver version as 3.6 or later.
  4. Copy the generated connection string. This is what you’ll need further.
  5. Replace the by your own password.
  6. Don't forget to whitelist your IP address.

You can always refer to the docs for help: https://docs.atlas.mongodb.com/connect-to-cluster/

  1. Now, make a new file ".env" in the project folder and then define the database URI you generated earlier, like this:
DATABASE = "Your generated mongoDB URI"

6. Start the Express server and React development server.

After performing all of the setup steps in the Getting started section, navigate to the project root directory and run the following command to start the Express server and React development server.

yarn start

After the development server has started, a Chrome browser window should open, and you should see the login screen for the application. If the browser does not automatically open after the server starts, you can verify that the application is working locally on your computer by opening Chrome and going to http://localhost:8000.

Contributing guide

1. Fork the project repository: Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account.

2. Clone your fork: Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the copy to clipboard icon.

Open a terminal and run the following git command:

git clone "place here the url you just copied"

3. Create a new branch: Change to the repository directory on your computer (if you are not already there):

cd first-contributions Now create a branch using the git checkout command:

git checkout -b your-new-branch-name

Make changes in your local repository

4. Commit your Changes: If you go to the project directory and execute the command git status, you'll see there are changes.

Add those changes to the branch you just created using the git add command:

git add .

Now commit those changes using the git commit command:

git commit -m "a meaningful message"

5. Push your changes to Github: Push your changes using the command git push:

git push origin add-your-branch-name

replacing "add-your-branch-name" with the name of the branch you created earlier.

6. Submit changes for review: If you go to your repository on GitHub, you'll see a Compare & pull request button. Click on that button and submit the Pull request. Comment about your pull request.

Soon I'll be merging all your changes into the master branch of this project. (delete your branch from your fork after pull request gets accepted)


Issues:

If you find an issue while using the app or have a request, log the issue. These issues will be addressed in a future code update.

Contributors

Aman Jagdev Kartik Goel Gautam Arora