LeCoff

Web app to help vendors of coffee beans and coffee products to manage their inventory.

Add issue

About

Full-stack, inventory management web app to enable basic CRUD operations for items, and categories.

Built in Express.js (Node.js), with PostgreSQL database (pg integration with Express.js) and EJS templating.

This project is part of The Odin Project's "Full Stack JavaScript" course. This is also my first full-stack project, so largely the focus has been just trying to get things built. It's also the first time I've used TailwindCSS as a front-end web developer 😅 (i love it btw).

Screenshots

View of all items in inventory:

View of managing the adding/removing of composite items (including creating a fresh item to the inventory) to a given category (here it is for "Coffee beans").

View of a confirmation modal for user to confirm they'd like to delete a category. Deleting a category also "orphans" its items.

Built with

Running locally

1. Fork then clone this repository,

2. Install all packages and dependencies

   npm i

3. Run PostgreSQL in terminal by running psql, and create the database:

   CREATE DATABASE coffee_inventory;
   

   You can verify if db was created using \l

4. Create a .env file in root of repository with your Postgres details. It should look like this:

    USER_NAME: "your_username"
    PASSWORD: "your_password"

5. Start development server and TailwindCSS (used for styling) build processes. You will need two terminals - one each - for these:

   npm run dev

   npm run build:css

Licence

Distributed under MIT Licence.

Acknowledgements

• Branding icon (including favicon) is from Flaticon
• All other (functional) icons are from Lucide
• Blank avatar image is from Vecteezy
• Markdown badges by ileriayo