Skip to content

A modern, native iOS client for ClassCharts with multiple theme options.

Notifications You must be signed in to change notification settings

itsnotrin/BetterClasscharts

Repository files navigation

BetterClasscharts

A modern, native iOS client for ClassCharts with multiple theme options.

Features

  • Native iOS app built with SwiftUI
  • Multiple theme options including:
    • Light/Dark mode
    • Catppuccin (Latte, Frappé, Macchiato, Mocha)
    • Dracula
    • Gruvbox (Light/Dark)
    • Tokyo Night
    • Synthwave '84
    • Rosé Pine
  • View homework assignments
  • Mark homework as complete/incomplete
  • View timetable day by day
  • Pull to refresh homework list
  • Session management

Screenshots

Login Screen Login Screen
Homework List Homework List
Homework Details Homework Details
Timetable View Timetable View
Timetable Day View Timetable Day View
Settings Settings
Theme Selection Theme Selection
Catppuccin Theme Settings Catppuccin Theme Settings

Installation

Option 1: Build from Source

  1. Clone the repository
  2. Open in Xcode
  3. Build and run on your iOS device or simulator

Option 2: Install Pre-built IPA

  1. Download the latest IPA from the Releases page
  2. Install using AltStore, Sideloadly, or similar sideloading tool
  3. Trust the app in Settings > General > Device Management
  4. Note: You'll need to reinstall every 7 days due to free development limitations

Usage

  1. Launch the app
  2. Enter your ClassCharts login details:
    • Date of Birth
    • Pupil Code
  3. View your homework and timetable
  4. Customize the appearance in Settings

Requirements

  • iOS 17.0 or later (may work on earlier versions but this is untested - your mileage may vary)
  • Xcode 15.0 or later
  • Valid ClassCharts account

Technical Details

  • Built with SwiftUI
  • Uses URLSession for networking
  • Implements proper error handling
  • Automatic token refresh
  • Secure credential storage using UserDefaults
  • Environment-based theme management

Contributing

Feel free to submit issues and enhancement requests!

License

[Your chosen license]

Acknowledgments

Disclaimer

This is an unofficial client for ClassCharts and is not affiliated with or endorsed by ClassCharts or Tes. I cannot guarantee that it will work for you, or that it will continue to work in the future.

About

A modern, native iOS client for ClassCharts with multiple theme options.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages