⚠️ This project is still in development and has not been extensively tested due to limited access to real-world data. If you encounter any issues, please open an issue.
- Timetables
- Grades
- Attendance
- Homework
- Announcements
🔗 Visit betterlibrus.vercel.app 🌲 To install on Android, visit this link and select "Install" when prompted
| Technology | Purpose | Version |
|---|---|---|
| Next.js | React Framework | 15.3.3 |
| React / React DOM | UI library | 18.3.1 |
| TypeScript | Type Safety | ^5 |
| Tailwind CSS | Styling | 3.4.1 |
| librus-api | Librus Synergia client | 2.1.0 |
| lucide-react | Icons | 0.475.0 |
| recharts | Charts | 2.15.1 |
| zod | Validation | 3.24.2 |
- Node.js 16.x or later
- npm, bun or yarn
-
Clone the repository
git clone https://github.com/0xhkamori/betterlibrus.git cd betterlibrus -
Install dependencies
npm install # or yarn install -
Start dev server
npm run dev # or yarn dev -
Open your browser
Navigate to http://localhost:9002 (default dev server port)
betterlibrus/
├── src/
│ ├── app/ # Next.js App Router pages & layouts
│ ├── components/ # Reusable UI components (ui/, student-hub/, auth/)
│ ├── lib/ # API client, utils and types
│ └── hooks/ # Custom React hooks
├── package.json
├── tsconfig.json
└── README.md
| Command | Description |
|---|---|
npm run dev |
Start development server (Next.js with Turbopack) on port 9002 |
npm run build |
Build for production |
npm run start |
Start production server |
npm run lint |
Run ESLint |
npm run type-check |
Run TypeScript compiler |
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Give a ⭐️ if this project helped you!
- Telegram: @astredic
- Issues: GitHub Issues
❤️ Made for the student community