Skip to content
AungS8430Public

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

228 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Schooler

License Languages Last Commit

Overview

Schooler is a web application that allows students to easily access resources and informations.


Features

  • Live timetable and class schedule
  • Downloadable academic calendar
  • Downloadable timetables
  • Create/view annoucements
  • View people and get contacts
  • Download resources

Tech Stack

  • Frontend: NextJS with TypeScript (located in frontend/)
  • Backend: FastAPI with sqlmodel (located in backend/)

Project Structure

schooler/
├── backend/      # Python backend code & API
├── frontend/     # NextJS frontend source code & assets
├── LICENSE
├── README.md

Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/AungS8430/schooler.git
    cd schooler
  2. Install frontend dependencies:

    cd frontend
    pnpm install
  3. Install backend dependencies:

    cd ../
    pip install -r requirements.txt

Preparations

Add data to backend/volumes the files include**

...
backend/
├── ...
├── volumes
├── ├── academicInfo.json
├── ├── info.json
├── ├── override.json
├── ├── resources.json
├── ├── slots.json
├── ├── special.json
├── ├── timetable.json
├── ...
...

Please view example in the respective files.

Create .env inside backend and frontend folders, view .env.example inside the respective directories.


Usage

  1. Start the backend server:

    cd backend
    fastapi run server.py
  2. Start the frontend development server:

    cd ../frontend
    pnpm start
  3. Open http://localhost:3000 in your browser.


Contributing

Contributions are welcome!
If you have suggestions, bug reports, or feature requests, please open an issue or submit a pull request.

Steps:

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

License

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


Contact

For questions or feedback, open an issue.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages