EduNex is a robust, production-grade e-learning and course-sharing platform designed for modern academies, schools, and content creators. Engineered on top of Laravel 12, Livewire 4, and Tailwind CSS 4, EduNex combines a beautiful, responsive interface with a commercial-ready Dual-Access monetization model, a zero-terminal installation wizard, and an open-core modular ecosystem ready for commercial marketplace expansion.
Explore Installation Guide • View Architecture Specs • Module Developer Guide • Run Test Suites
EduNex is not just an academic prototype; it is structured as a premium commercial software distribution:
- 🔌 Zero-Terminal Web Installer: A clean, multi-step web wizard at
/installthat verifies PHP extensions, tests and configures the database connection, performs background database setup, and initializes the platform's super-admin without touching a command line. - 💳 Dual-Access Revenue Model: Supports flexible course monetization out of the box. Charge students for individual lifetime course purchases, recurring monthly membership plans, or offer courses as free assets with structured access controls.
- 🧩 Open-Core Modular Architecture: An dynamic core designed to be extended. Integrates seamlessly with private extensions in the
Modules/directory using standard Git isolation protocols, protecting proprietary add-ons while maintaining an open-source core. - 🔄 OTA 1-Click Updates: An automated over-the-air updater service that allows admins to safely download, extract, and execute background schema migrations and assets updates from a centralized marketplace API.
- 📊 Role-Specific Portals: Separated, secure user environments for:
- Students: Sleek learning views, progress trackers, quizzes, certificates, and bookmark managers.
- Instructors: Full-featured course builder, quiz manager, grading dashboards, student submission trackers, and announcements.
- Admins: User management, course moderation, global subscription plans management, and platform analytics.
- 📑 Invoicing & Auto-Biller: Integrated background generator creating automated invoice and fee challans with printable formats and barcodes for streamlined payments.
EduNex leverages the absolute latest in the Laravel ecosystem:
- Backend: PHP 8.2+ with Laravel 12 (streamlined configuration schema).
- Reactivity: Livewire 4 (blazing fast, component-based server-driven SPAs) and Alpine.js.
- Design Tokens: Tailwind CSS 4, Bootstrap 5 custom variables, and sleek dark mode overrides.
- Authentication: Headless authentication engine powered by Laravel Fortify.
- Document Engines: dompdf for dynamic, secure PDF certificates and billing invoices.
The diagram below details the decoupled routing, core role-based access controllers, and the database synchronization mechanism built into EduNex:
graph TD
User([Platform Request]) --> Router{Laravel Route Group}
%% Setup / Install Route
Router -- "/install" --> Installer[Livewire Setup Wizard]
Installer --> EnvUpdate[Configure .env]
Installer --> MigrateSeed[Migrate & Seed Core DB]
%% Authenticated Flows
Router -- "/student/*" --> StudentMW[role:student Middleware]
Router -- "/instructor/*" --> InstructorMW[role:instructor Middleware]
Router -- "/admin/*" --> AdminMW[role:admin & verified.admin]
%% Authorization Gate for Content
StudentMW --> CourseAccessGate{CheckCourseAccess Middleware}
CourseAccessGate -- Free Course --> CourseView[Livewire CourseView]
CourseAccessGate -- Lifetime Purchase --> CourseView
CourseAccessGate -- Active Subscription --> CourseView
CourseAccessGate -- Locked --> SubscriptionPage[Browse Subscriptions / Purchase Course]
%% Admin modular hooks
AdminMW --> Marketplace[OTA Updates / Plugins Dashboard]
Marketplace --> ZIPService[OTA ZIP Extraction Service]
ZIPService --> ModulesFolder[(Modules/ Directory)]
To spin up a local development environment, follow these steps:
- Clone the repository:
git clone https://github.com/syftnex/edunex.git cd edunex - Spin up the Sail containers:
./vendor/bin/sail up -d
- Run the initial setup scripts:
./vendor/bin/sail composer run setup
- Access the application:
Open
http://localhostin your browser.
- Install PHP packages:
composer install
- Environment Configuration:
cp .env.example .env php artisan key:generate
- Database Configuration:
Configure your
.envwith a database client, then create the schema:php artisan migrate --seed
- Install and compile frontend assets:
npm install npm run build
- Serve locally:
php artisan serve
The core files are organized according to standard Laravel 12 paradigms:
EduNex/
├── app/
│ ├── Actions/ # Core business actions (Fortify authentication actions)
│ ├── Http/
│ │ └── Middleware/ # Access guards (CheckCourseAccess, RoleManager)
│ ├── Livewire/ # Server reactive components (Admin, Student, Instructor)
│ └── Models/ # Database entities & casts (User, Course, Subscription)
├── bootstrap/
│ └── app.php # Modern Laravel 12 configuration, routing & middlewares
├── config/ # Application configuration schemas
├── database/
│ ├── migrations/ # Database structural migrations
│ └── seeders/ # Interactive database seeders
├── docs/ # Detailed project documentation
├── public/ # Client assets & Compiled vite bundles
├── resources/
│ ├── css/ # Tailwind v4 directives and Bootstrap variable files
│ └── views/ # Blade UI views and Livewire templates
├── routes/
│ ├── web.php # Core web routing
│ └── console.php # Artisan scheduled tasks and console definitions
└── tests/ # PHPUnit test suites (Feature & Unit)
This repository is distributed under the terms of the GNU Affero General Public License v3.0 (AGPL-3.0).
Important
Network Interaction Copyleft: Under Section 13 of the AGPL-3.0, if you modify the EduNex software and run it on a server for other users to interact with remotely over a network, you MUST make the complete Corresponding Source code of your modified version available to all network users at no charge.
We highly recommend maintaining a public GitHub repository with your custom modifications to easily comply with the copyleft clauses of the license. Please refer to LICENSE.md for full legal text.
- Issues & Bugs: Please report any bugs or feature requests on our GitHub Issue Tracker.
- Documentation: Comprehensive blueprints can be accessed at the docs/ directory.
- Premium Add-ons: Visit the official marketplace on Syftnex to purchase barcoded challan generators, easy payment gateways (JazzCash/Easypaisa/Stripe), and enterprise extensions.