Enchanted Oasis

Enchanted Oasis is an open-source Hogwarts-themed school management portal built with Next.js and ChakraUI, providing role-based dashboards for admins, faculty, and students to manage courses, house points, and announcements.

What is Enchanted Oasis?

Enchanted Oasis is a school management portal built with Next.js on the frontend and Vercel serverless functions with MongoDB Atlas on the backend. It implements three distinct roles — Admin, Faculty, and Student — each with its own authentication and dashboard. The application takes user credentials through a login form (demo accounts are provided for each role) and produces role-specific interfaces for managing courses, students, house points, and announcements. The project is available on GitHub and includes a live demo deployed at https://enchanted-oasis.vercel.app.

Key Features

• Role-based authorization — Three distinct roles (Admin, Faculty, Student) with separate login flows and permissions; demo accounts for each are listed in the README.
• Admin course management — Admins can add, update, and delete courses, faculties, and students from a dashboard.
• House points tracking — A system for awarding points to Hogwarts houses, with tracking visible to users.
• Announcements — Admins can post announcements that are delivered to students and faculty.
• Student course registration — Students can register, drop, or view courses, and access course material through their profile.
• Faculty roster management — Faculty can view, add, and delete students.
• Event notifications — Students and faculty receive notifications for upcoming events and examinations.
• Tech stack — Next.js (React) frontend styled with ChakraUI, backend built on Vercel serverless functions and MongoDB Atlas for data storage.

Who is it for?

• School administrators — manage the entire academic environment: adding courses, faculty, and students, and posting announcements.
• Teachers/faculty — manage student rosters, track house points, and receive notifications about events.
• Students — register and drop courses, view course materials, check house points, and get notified of examinations.
• Developers — use it as a starting template for building role-based school or education portals, with a pre-configured demo deployment on Vercel.

What can you do with Enchanted Oasis?

• Hogwarts-themed demo: log in as admin, faculty, or student using the provided credentials at the live demo site (https://enchanted-oasis.vercel.app) to explore each role's interface.
• Build a school portal: quickly adapt the Next.js + ChakraUI + MongoDB structure to create a custom school management system with role-based auth.
• Learn full-stack patterns: study how Vercel serverless functions integrate with MongoDB Atlas and how ChakraUI components are used for dashboards.
• Run locally: clone the repository, install dependencies with npm install, and start the development server with npm run dev.

How does Enchanted Oasis work?

The project is a Next.js application with serverless API routes deployed on Vercel, backed by MongoDB Atlas. Users authenticate with credentials; the frontend then loads role-specific dashboards. Course and student data is stored in MongoDB and accessed via serverless functions. To run locally, you clone the repo, install dependencies with npm install, and start development with npm run dev.

FAQ

Is there a live demo?

Yes, a live demo is deployed at https://enchanted-oasis.vercel.app. You can log in with the provided demo accounts: [email protected] / admin888, [email protected] / faculty888, [email protected] / student888.

What tech stack does Enchanted Oasis use?

The frontend uses Next.js (React) with ChakraUI for styling. The backend relies on Vercel serverless functions and MongoDB Atlas for data storage.

Can I run Enchanted Oasis locally?

Yes. Clone the repository, run npm install, then npm run dev to start the development server.

Who can use Enchanted Oasis?

It has three roles: Admin, Faculty, and Student. Admin manages courses and users, faculty manages students, and students register for courses and view materials.

Is Enchanted Oasis free?

The GitHub repository is public and the README does not mention any pricing. The live demo is publicly accessible with the provided credentials.