🚀 CODSOFT

Comprehensive Internship Project Collection

Interactive Games • Problem Solving • Real-World Applications • Production-Ready

Projects • Quick Start • Tech Stack • Releases

📖 About

CODSOFT is a collection of standalone Java internship tasks grouped under one parent repository. Each task folder is self-contained and keeps its own README.md, LICENSE, and .gitignore so the project can be run, shared, and maintained independently.

The repository currently includes CLI applications for a number game, a student grade calculator, and a currency converter. The root .gitignore exists to keep compiled Java classes, IDE metadata, and temporary files out of version control across all task folders.

✨ Highlights

✅ Multi-project internship repository with clear task-wise separation
✅ Java CLI applications with robust input handling and error management
✅ Real-world problem-solving focused on practical applications
✅ Release assets for end users (downloadable executables)
✅ Source-code archives per project for easy distribution
✅ Consistent professional documentation and organization
✅ Cross-platform compatibility (Windows, Linux, macOS)
✅ MIT Licensed - free to use, modify, and distribute

🏷️ GitHub Topics

Use these topics in the GitHub About section to make the repository easier to discover:

codsoft
java
cli
console-application
interview-project
student-project
currency-converter
number-game

📦 Releases

Each task folder contains the full source code, launcher scripts, license, and its own README. If you publish GitHub Releases for this repository, attach either:

the source code archive for the task folder, or
a compiled release artifact such as a .jar file for Java users.

Recommended release notes:

what changed in the task
how to run it from source
what file to download from Releases

📦 Projects

Task	Project	Folder	Description	Status
Task 1	Number Game	`Task1_NumberGame`	Interactive CLI number guessing game with scoring system	✅ Active
Task 2	Student Grade Calculator	`Task2_StudentGradeCalculator`	Calculates total marks, average percentage, and grade	✅ Active
Task 4	Currency Converter	`Task4_CurrencyConverter`	Converts amounts between supported currencies	✅ Active

🛠️ Tech Stack

Core Framework

Java 11+ — High-performance, strongly-typed programming language
Command Line Interface — Native console-based user interaction

Build & Distribution

Native Compilation — Direct javac compilation (no build tools required)
Batch/Shell Scripts — Cross-platform launcher utilities
Launch4j — Optional executable wrapper for Windows distribution

📁 Repository Structure

CODSOFT/
├── Task1_NumberGame/
│   ├── NumberGame.java
│   ├── run.bat
│   ├── run.sh
│   ├── README.md
│   ├── LICENSE
│   └── .gitignore
├── Task2_StudentGradeCalculator/
│   ├── StudentGradeCalculator.java
│   ├── run.bat
│   ├── run.sh
│   ├── README.md
│   ├── LICENSE
│   └── .gitignore
├── Task4_CurrencyConverter/
│   ├── CurrencyConverter.java
│   ├── run.bat
│   ├── run.sh
│   ├── README.md
│   ├── LICENSE
│   └── .gitignore
├── README.md                         # Root project overview
├── LICENSE                           # MIT License
├── .gitignore                        # Git ignore rules
└── (task folders remain self-contained)

🚀 Quick Start

Prerequisites

Java 11 or higher
Git (for cloning the repository)
Command Line Interface (Terminal, Command Prompt, or PowerShell)

1) Clone Repository

git clone https://github.com/YOUR_USERNAME/CODSOFT.git
cd CODSOFT

2) Navigate to Project

cd Task1_NumberGame

3) Run Project

Windows

run.bat

Linux/macOS

chmod +x run.sh
./run.sh

Manual Compilation

javac NumberGame.java
java NumberGame

Use the same pattern inside Task2_StudentGradeCalculator or Task4_CurrencyConverter for the other tasks.

Verify Java Installation

java -version

If not installed: Download Java

📖 Project Documentation

Each project includes:

README.md — Comprehensive project documentation
Quick Start Guide — Setup and execution instructions
Code Architecture — Design patterns and structure explanation
Gameplay/Usage Guide — Step-by-step user instructions
Troubleshooting — Common issues and solutions
Learning Objectives — Educational concepts demonstrated

Quick Links

Task 1: Number Game — Interactive guessing game
Task 2: Student Grade Calculator — Marks, averages, and grades
Task 4: Currency Converter — Multi-currency conversion tool

💻 System Requirements

Minimum Requirements

OS: Windows 7+, macOS 10.9+, Linux (any modern distribution)
Java: JDK 11 or higher
RAM: 256 MB minimum
Disk: 50 MB per project

Recommended Requirements

Java: JDK 17 LTS or higher
RAM: 2 GB or more
Disk: 500 MB for all projects

📦 Installation & Distribution

For Users - Running Pre-Compiled

Download the .exe file from Releases (Windows)
Double-click to run (no Java installation needed for packaged versions)
Or use launcher scripts on Linux/macOS

For Developers - Building from Source

Clone the repository
Ensure Java 11+ is installed
Navigate to project folder
Run: javac SourceFile.java && java SourceFile

Creating Standalone Executables

Optional: Convert projects to .exe for Windows distribution:

# Using Launch4j
1. Download from: http://launch4j.sourceforge.net/
2. Configure with project JAR
3. Generate .exe wrapper
4. Distribute standalone executable

🔄 Workflow & Contribution

Getting Started with Development

Fork the repository
Create a feature branch
Make your changes
Commit and push
Submit a Pull Request

Commit Message Format

[TASK-X] Brief description

Detailed explanation if needed
- Bullet point for changes
- Another change

Fixes #issue_number

Code Style Guidelines

Follow Java naming conventions (camelCase for variables/methods, PascalCase for classes)
Use meaningful variable and method names
Add comments for complex logic
Maintain consistent indentation (4 spaces)
Keep methods focused and under 50 lines when possible

📊 Statistics

Metric	Value
Total Projects	3+
Total Lines of Code	500+
Java Classes	5+
Documentation Files	3+
Test Coverage	Ongoing

🔗 Important Links

GitHub Repository: CODSOFT
Releases: Download Executables
Issues: Report Problems
Java Documentation: docs.oracle.com

🐛 Troubleshooting

Java Not Found

# Solution: Download and install Java
java -version

Permission Denied (Linux/macOS)

# Solution: Make script executable
chmod +x run.sh

Compilation Error

# Ensure you're in the correct directory
cd Task1_NumberGame
javac NumberGame.java

The same idea applies to the other task folders: run the compile command from inside the folder that contains the Java file.

📞 Support & Contact

Issues: Open an issue on GitHub Issues
Discussions: Use GitHub Discussions
Email: contact@codsoft.example.com (if applicable)

📄 License

This project is licensed under the MIT License.

You are free to:

✅ Use commercially
✅ Modify and create derivatives
✅ Distribute the software
✅ Use privately

Under the condition that:

⚠️ License and copyright notice must be included

See LICENSE file for full details.

🏆 Recognition

CODSOFT Internship Program — For the learning opportunity
Java Community — For excellent documentation and tools
Contributors — For improvements and feedback

🎯 Roadmap

Task 1 - Number Game (v1.0.0)
Task 2 - Student Grade Calculator (v1.0.0)
Task 4 - Currency Converter (v1.0.0)
Publish GitHub Releases for each task
Add GitHub topics to the repository About section
Automated Release Builds (CI/CD)
Web-based versions
Mobile adaptations
Performance optimizations

Made with ❤️ by LegendarySumit

Building practical solutions, one project at a time

⬆ back to top

Last Updated: 2026-06-06
Status: 🟢 Active Development

Name		Name	Last commit message	Last commit date
Task1_NumberGame		Task1_NumberGame
Task2_StudentGradeCalculator		Task2_StudentGradeCalculator
Task4_CurrencyConverter		Task4_CurrencyConverter
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation