Skip to content

kkathriarachchie/GPAstic

Repository files navigation

🎓 GPAstic

A modern, user-friendly web application for calculating SGPA (Semester Grade Point Average) and CGPA (Cumulative Grade Point Average) with comprehensive data management features.

GPA Calculator Next.js React TypeScript Tailwind CSS

all

✨ Features

  • 📊 SGPA & CGPA Calculation: Accurate calculations following official academic standards
  • 🎨 User-Friendly Interface: Intuitive design for easy data entry and clear results
  • 💾 Data Management: Import/export your data as CSV for backup or transfer
  • 📈 Progress Tracking: Visualize your academic progress across all semesters
  • 🔒 Privacy First: All data is stored locally in your browser - no external servers
  • 📱 Responsive Design: Works seamlessly on desktop and mobile devices

🚀 Demo

Live Demo

📋 Prerequisites

Before you begin, ensure you have the following installed:

🛠️ Installation

  1. Clone the repository:

    git clone https://github.com/kkathriarachchie/GPAstic.git
    cd GPAstic
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Run the development server:

    npm run dev
    # or
    yarn dev
  4. Open your browser: Navigate to http://localhost:3000 to see the application.

📖 Usage

Getting Started

  1. Enter Module Details: Add your modules, codes, and credit hours for each semester
  2. Select Grades: Choose grades for each module; GPA is calculated automatically
  3. Track Progress: View SGPA for each semester and overall CGPA
  4. Export/Import Data: Backup your data or transfer between devices using CSV

Data Import & Export

  • Export: Click the "Export" button in the header to download your data as a CSV file
  • Import: Click the "Import" button and select a previously exported CSV file to restore your data

Note: All data is stored locally in your browser. No information is sent to external servers, ensuring complete privacy.

🏗️ Project Structure

gpa_cal/
├── components/          # Reusable React components
├── pages/              # Next.js pages
├── styles/             # CSS and styling files
├── utils/              # Utility functions
├── types/              # TypeScript type definitions
├── public/             # Static assets
└── README.md

🛠️ Technologies Used

📱 Screenshots

Loding 1 2 3 4 Guid&About

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

👨‍💻 Developer

Kavishka Kathriarachchie
Full Stack Developer

Available for freelance projects and collaborations.

📞 Support

If you encounter any issues or have questions, please:

  1. Check the Issues page
  2. Create a new issue if your problem isn't already reported
  3. Contact the developer directly via email

Star this repository if you find it helpful!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published