cpp-beginner-projects

📖 Overview

This repository contains beginner-friendly C++ console projects for practicing core programming concepts through small and practical exercises.

Focus areas:

• Input and output
• Conditional logic (if/else, switch)
• Loops
• Basic calculations and validation

---

⚙️ How This Repository Works

• Each .cpp file is an independent mini project.
• Every project has a matching explanation file in project-readmes/.
• Each project README follows the same format:
  • Overview
  • How It Works
  • Requirements
  • Compile & Run

---

📂 Projects and Detailed READMEs

1. Bill Splitter
2. Cutoff Checker
3. Day Name And Type
4. Electricity Bill Calculator
5. Grade Evaluator
6. Mini ATM
7. Movie Ticket Counter
8. Petrol Pump Dispensor
9. Pin Validator
10. Ride Fare Program
11. Simple Calculator
12. Smart Card Fare System
13. Table Maker
14. Temperature Converter
15. Voting Eligibility Checker
16. Water State Checker

---

🧱 Consistent Project Structure

repo-root/
├── README.md
├── LICENSE
├── <Program_Name>.cpp
└── project-readmes/
    ├── <Program_Name>.md
    └── ...

Consistency rules:

• Keep source file names in Pascal_Case_With_Underscores.
• Keep project README file names matching source names.
• Add each new project link in the root README project list.
• Keep the same 4-section template in every project README.

---

➕ Adding a New Project (Checklist)

1. Add a new source file (.cpp in this repo).
2. Add its documentation in project-readmes/<Program_Name>.md.
3. Follow the standard 4-section README format.
4. Add the project link to the root README list.

---

🛠️ Requirements

• A C++ compiler (for example, g++)
• Terminal / command prompt

---

▶️ How to Run Any Project

1. Clone the repository:

   git clone https://github.com/yash-kumar-18/cpp-beginner-projects.git
   cd cpp-beginner-projects

2. Compile a project (example: Simple_Calculator.cpp):

   g++ Simple_Calculator.cpp -o Simple_Calculator

3. Run it:

   ./Simple_Calculator

Repeat the same compile-and-run process for any other .cpp file.

---

📄 License

This project is licensed under the MIT License.
See LICENSE for full details.

---

🎯 Goal

Build strong C++ basics with project-based learning.