Skip to content
This repository has been archived by the owner on Feb 23, 2020. It is now read-only.
/ home-inventory Public archive

A simple home inventory app built with Node and React

Notifications You must be signed in to change notification settings

edwinmah/home-inventory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Inventory app with Node and React

Build Status

Purpose

Use this app to keep track of the items that you own. Your home inventory can serve as documentation of asset values for insurance coverage and claims and for charitable contributions. Alternatively, use the app as a wish list of items that you want to purchase or receive as a gift. Or if you’re a follower of the voluntary simplicity lifestyle, use the app to become more aware of how little you own and the future purchases you want to avoid.

App features include category filtering, custom categories, image uploading, and personalized inventory accounts via Google authorization.

While home inventory tracking is the original purpose of the app, it can be repurposed to track almost anything, e.g., vinyl records, baseball cards, comic books, stamps, coins, etc.

Getting started

  1. Install dependencies:

     npm install
    
  2. Open s3bucket-name.js and enter your AWS S3 bucket name:

     export const s3bucketName = 'YOUR_AWS_S3_BUCKET_NAME';
    
  3. Create a Google App from the Google Developers console.

  4. Create an .env file and enter your secret AWS and Google credentials and your ROOT_URL (which may differ from the example below depending on your local dev setup):

     export AWS_ACCESS_KEY_ID='YOUR_SECRET_AWS_ACCESS_KEY_ID'
     export AWS_SECRET_ACCESS_KEY='YOUR_SECRET_ACCESS_KEY'
     export GOOGLE_CLIENT_ID='YOUR_GOOGLE_CLIENT_ID'
     export GOOGLE_CLIENT_SECRET='YOUR_GOOGLE_CLIENT_SECRET'
     export ROOT_URL='http://localhost:8080'
    
  5. If you're using Travis, you'll also want to add the encrypted credentials to the .travis.yml file.

  6. Likewise, if you're deploying to Heroku, you'll want to add your encrypted API key to .travis.yml and create vars in Heroku for your env variables and mLab (or other MongoDB service) database URL.

  7. Start the development environment:

     npm run dev
    
  8. Run local tests:

     npm run test-local
    
  9. When you’re ready for production, generate a production build:

     npm run build-prod
    

Screenshots of features

Google authorization

Fig. 1 – Google authorization


View all items

Fig. 2 – View all items


Filter items by category

Fig. 3 – Filter items by category


View a single item

Fig. 4 – View a single item


Edit an item

Fig. 5 – Edit an item


Add or edit categories

Fig. 6 – Add or edit categories


View account information

Fig. 7 – View account information

Technology used

About

A simple home inventory app built with Node and React

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published