Giter Club home page Giter Club logo

livestock's Introduction

Herdmaster

Tool to help farmers with tracking their inventory and cattle growth.

Tech Stack

  • Back End: ExpressJS/NodeJS, Mongoose/MongoDB.
  • Front End: Next JS, React ChartJS, Framer Motion, CSS Modules.

Live Demo

https://livestockapp.vercel.app/

Showcase

Livestock Demo

About

My dad is a farmer back in Brazil and he manages his inventory with pen and paper, making it difficult to keep track of everything across numerous sheets. To assist him (and myself), I created an app that enables us to record cattle growth, health, purchases, sales, and even estimate profits.

Features

Client users can:

  • Add individual animals with name, color, breed, weight, date of purchase, rate, health condition and description.
  • Add batches with animals, seller, notes and purchase date.
  • Add pastures with name, condition and area.
  • Visualize averages: active cattle weight and monthly growth.
  • Visualize total investment (active cattle).
  • Sort and filter animals.
  • Add weight logs to an animal and keep track of it with visualized data.
  • Move/Remove/Add animals to pastures
  • Simulate a sale and visualize investments, profits and growth.

With the API, you could get/add/remove/edit animals, batches and pastures, as well as add and removing weight logs. Check out this Postman documentation for more info on the API: https://documenter.getpostman.com/view/12400552/2s93RQTu4s#intro

Installation

You'll need a MongoDB account in order to run the app.

Environment Variables

To run this project, you will need to add the following environment variables:

To your /api/.env file:

DATABASE - Your MongoDB connection string.

DATABASE_PASSWORD - Your MongoDB password. We will replace the in the connection string with this.

PORT - (optional) The port you'll run the app locally.

To your /ui/.env.local file:

API_BASE_URL - Your base URL for client requests in the ui/utils/axios.js file

Run Locally

Clone the project

  git clone https://github.com/pedroenriquedev/LiveStock.git

Go to the project directory

  cd my-project
  cd api

Install server dependencies

  npm install

Install client dependencies

  cd ..
  cd ui
  npm install

Start the client

  npm run dev

Start the server

  npm run server

Support

For support, please email [email protected].

livestock's People

Contributors

pedroenriquedev avatar pedroenriquexavier avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.