Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

52 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” CoopKeeper CLI

C++ CLI App Status

A feature-rich C++ command-line application for managing backyard chickens, tracking egg production, analyzing costs, and monitoring coop operations.

Built with real-world data modeling, object-oriented design, and persistent data storage.

Designed to replace spreadsheets and manual tracking with a structured, data-driven system.


πŸ’‘ Why CoopKeeper?

CoopKeeper was built to solve a real-world problem: managing backyard chicken operations efficiently.

Instead of spreadsheets or scattered notes, this tool provides a structured, data-driven way to:

  • Track production trends
  • Monitor costs
  • Maintain coop health
  • Make informed decisions over time

🎬 Demo Video

Full walkthrough of CoopKeeper’s features and CLI interface:

CoopKeeper Demo

▢️ Click to watch full demo


⚑ Highlights

  • πŸ“Š Real-time egg production dashboard
  • πŸ“… Monthly filtering across all record types
  • πŸ’° Accurate cost-per-egg and cost-per-dozen calculations
  • πŸ” Realistic seasonal production modeling
  • πŸ’Ύ Persistent storage using TXT + CSV export

🧰 Tech Stack

  • Language: C++
  • Architecture: Object-Oriented Programming (OOP)
  • Data Storage: Pipe-delimited TXT files
  • Export: CSV
  • Interface: Command-Line Interface (CLI)

πŸ“Š Key Metrics Tracked

  • Egg production trends (daily, weekly, monthly)
  • Lay rate (%) per flock
  • Cost per egg and per dozen
  • Feed cost tracking over time
  • Cleaning frequency and maintenance intervals

πŸ§ͺ Example Use Case

A backyard chicken owner can use CoopKeeper to:

  • Track daily egg production trends
  • Monitor feed costs over time
  • Identify seasonal drops in productivity
  • Stay on top of coop maintenance

This turns raw data into actionable insights for better flock management.


πŸš€ Features

πŸ“Š Smart Dashboard

  • Eggs today, last 7 days, and current month
  • Lay rate (%) with performance status:
    • Excellent / Good / Fair / Low
  • Financial insights:
    • Cost per egg
    • Cost per dozen
  • Production analytics:
    • Best production day
    • Monthly trend vs previous month
  • Maintenance tracking:
    • Last cleaning date
    • Smart alerts (low production, overdue cleaning)

πŸ₯š Egg Tracking

  • Add, edit, delete egg records
  • Chronologically sorted records
  • Monthly filtering
  • Daily totals and production trends

🌽 Feed Tracking

  • Track feed purchases and costs
  • View full history
  • Monthly filtering

πŸ’° Expense Tracking

  • Log coop-related expenses
  • Categorize spending
  • Monthly summaries
  • View expenses by month

🧹 Cleaning Records

  • Track coop cleaning activity
  • Monitor cleaning frequency
  • Monthly filtering

🩺 Health Notes

  • Track chicken health issues
  • Log observations per bird
  • Monthly filtering

πŸ–ΌοΈ Screenshots

Dashboard

Dashboard

Egg Records

Egg Records

CSV Export Confirmation

CSV Export


πŸ“ Project Structure

CoopKeeper/
β”‚
β”œβ”€β”€ data/
β”‚   β”œβ”€β”€ Chickens.txt
β”‚   β”œβ”€β”€ EggRecords.txt
β”‚   β”œβ”€β”€ FeedRecords.txt
β”‚   β”œβ”€β”€ Expenses.txt
β”‚   β”œβ”€β”€ CleaningRecords.txt
β”‚   └── HealthNotes.txt
β”‚
β”œβ”€β”€ exports/
β”‚   └── CSV files generated here
β”‚
β”œβ”€β”€ screenshots/
β”‚   β”œβ”€β”€ dashboard.png
β”‚   β”œβ”€β”€ eggs.png
β”‚   β”œβ”€β”€ export.png
β”‚   └── thumbnail.jpg
β”‚
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ CoopTracker.cpp / .h
β”‚   β”œβ”€β”€ Chicken.cpp / .h
β”‚   β”œβ”€β”€ EggRecord.cpp / .h
β”‚   β”œβ”€β”€ FeedRecord.cpp / .h
β”‚   β”œβ”€β”€ Expense.cpp / .h
β”‚   β”œβ”€β”€ HealthNote.cpp / .h
β”‚   β”œβ”€β”€ CleaningRecord.cpp / .h
β”‚   └── Utils.cpp / .h
β”‚
└── main.cpp

πŸ“… Data Format

All data is stored in pipe-delimited .txt files:

MM/DD/YYYY|field|field|...

Example

04/09/2026|17|Strong spring production

πŸ“ˆ Realistic Simulation

  • 20-hen flock model
  • Seasonal production patterns:
    • Spring/Summer β†’ peak production
    • Winter β†’ reduced output
  • Realistic feed and expense tracking
  • Accurate cost-per-dozen calculations

πŸ’‘ Example Output

Today's Lay Rate: 85.00% (17/20) - Excellent
Cost Per Dozen: $3.99
Best Day: 04/07/2026 (19 eggs)
Production Trend: [UP] +24.74%

πŸ› οΈ How to Run

  1. Clone the repository:
git clone https://github.com/Holidazee/CoopKeeper-CLI.git
  1. Open in Visual Studio 2022

  2. Ensure required folders exist:

/data
/exports
/screenshots
  1. Build and run

🧠 Technical Concepts Demonstrated

  • Object-Oriented Programming (OOP)
  • File I/O (TXT + CSV export)
  • Data parsing and validation
  • Sorting and filtering
  • Date-based querying (month/year filtering)
  • Real-world data modeling

πŸ”₯ Future Improvements

  • Profit tracking (egg sales)
  • Per-chicken productivity tracking
  • GUI version (Qt or web app)
  • Graphs and analytics

πŸ‘¨β€πŸ’» Author

Taylor Burris


⭐ Support

If you found this project helpful or interesting, consider starring the repo!

About

C++ CLI app for managing backyard chickens with real-time egg production tracking, cost analysis, and month-based data filtering.

Topics

Resources

Stars

Watchers

Forks

Packages

Contributors

Languages