https://github.com/prmntr/teachassist
A TeachAssist app for YRDSB, written in React Native
https://github.com/prmntr/teachassist
app education react-native typescript
Last synced: 5 months ago
JSON representation
A TeachAssist app for YRDSB, written in React Native
- Host: GitHub
- URL: https://github.com/prmntr/teachassist
- Owner: prmntr
- License: mit
- Created: 2025-08-19T00:27:59.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2026-01-22T19:18:16.000Z (6 months ago)
- Last Synced: 2026-01-23T12:12:00.952Z (6 months ago)
- Topics: app, education, react-native, typescript
- Language: TypeScript
- Homepage:
- Size: 18.3 MB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
TeachAssist: Check Your Grades
An unofficial mobile app for the YRDSB TeachAssist portal.
Not affiliated with YRDSB or The TeachAssist Foundation!
## Overview
TeachAssist provides students with an open source streamlined mobile experience to access their academic information from the York Region District School Board's TeachAssist portal (ta.yrdsb.ca). View your grades, track performance over time, and get assignment feedback - all in a clean, native mobile interface.
## Features
### Current Features
- 📊 **Grade Tracking** - View current marks and performance across all classes
- 📅 **Appointment Booking** - Book, view, and cancel guidance appointments directly from the app
- 🔔 **Notifications** - Get notified when your marks change and guidance appointments
- 📈 **Trend Analysis** - Track your progress over time with detailed analytics
- 🔮 **Performance Prediction** - Add and edit assignments to forecast course performance
- 📝 **Assignment Feedback** - Access teacher feedback on individual assignments
- 📱 **Mobile-Optimized Interface** - Clean, intuitive design built specifically for mobile devices
- 🔐 **Privacy Features** - End-to-end encryption with YRDSB credentials, plus options to restrict and lock who sees your grades
- ⚡ **Fast Performance** - Quick access to your academic data
### Coming Soon
- ⏹️ **Widgets** - See your marks at a glance without ever opening the app
- 🧑💻 **API** - Interface with the TeachAssist website through code
- 🍎 **iOS Support** - Support for Apple devices
## Screenshots
## Privacy & Security
- **No Data Storage**: Your credentials and academic data stay private between you, your device, and TeachAssist
- **Direct Connection**: The app connects directly to the official YRDSB TeachAssist portal
- **Local Processing**: All data processing happens locally on your device
- **Secure Authentication**: Securely authenticates with the YRDSB portal
## Installation
### For Users
- **Android: [Play Store](https://play.google.com/store/apps/details?id=com.prmntr.teachassist)**
- **Web: [TeachAssist](https://prmntr.com/teachassist)**
- **iOS: [Coming Soon](/)**
### For Developers
#### Prerequisites
- Node.js (v16 or higher)
- npm or yarn
- Expo CLI
- iOS Simulator (for iOS development), Android Studio (for Android development), or an iOS or Android device
#### Setup
1. Clone the repository:
```bash
git clone https://github.com/prmntr/teachassist.git
cd teachassist
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Start the development server:
```bash
npx expo start
```
4. Run on your preferred platform:
- **iOS**: Press `i` in the terminal or scan the QR code with your iPhone camera
- **Android**: Press `a` in the terminal or scan the QR code with the Expo Go app
## Tech Stack
- **Framework**: React Native
- **Platform**: Expo
- **Language**: JavaScript/TypeScript
- **Authentication**: Secure credential handling for YRDSB portal
- **API Integration**: Custom wrapper for ta.yrdsb.ca
## Contributing
Contributions are welcomed. Here's how you can help:
1. **Fork the repository**
2. **Create a feature branch**: `git checkout -b feature/amazing-feature`
3. **Make your changes**: Implement your feature or fix
4. **Test thoroughly**: Ensure your changes work as expected
5. **Commit your changes**: `git commit -m 'Add amazing feature'`
6. **Push to the branch**: `git push origin feature/amazing-feature`
7. **Open a Pull Request**: Describe your changes and their benefits
## Support
If you encounter any issues or have questions:
- 🐛 **Bug Reports**: Open an issue on GitHub
- 💡 **Feature Requests**: Submit an issue with the "enhancement" label
- 📧 **Contact**: [Google Forms](https://forms.gle/BECBr8LqgtnzzHqS6)
## Disclaimer
**This app is an unofficial mobile client for the YRDSB TeachAssist portal. It is not affiliated with, endorsed by, or officially connected to the York Region District School Board or The TeachAssist Foundation. All academic data is retrieved directly from the official ta.yrdsb.ca portal. I am not responsible for any information displayed on the app. USE THIS APP AT YOUR OWN RISK!**
## License
This project is licensed under the MIT License - see the [LICENCE](LICENCE) file for details.
---
**Made with ☕,📜 & 🧋**