A comprehensive web portal for the Engineering Faculty Students' Union (EFSU) at the University of Moratuwa. This Laravel-based application provides a centralized platform for student engagement, communication, and resource sharing.
- News & Announcements: Stay updated with the latest news and important announcements
- Event Management: Discover and manage upcoming events and activities
- Student Resources: Access academic resources and study materials
- Photo Gallery: Browse through memorable moments and events
- Union Merchandise: Shop for official EFSU merchandise
- Forum: Engage in discussions with fellow students
- Contact Directory: Find important contact information
- Newsletter: Subscribe to regular updates
- User Dashboard: Personalized experience for registered users
- Backend: Laravel 12 with PHP 8.2+
- Frontend: Livewire, Volt, and TailwindCSS with DaisyUI
- Database: SQLite (configurable)
- Build Tools: Vite
- Testing: Pest PHP
- Clone the repository
- Install PHP dependencies:
composer install - Install Node.js dependencies:
npm install - Copy environment file:
cp .env.example .env - Generate application key:
php artisan key:generate - Run migrations:
php artisan migrate - Seed the database:
php artisan db:seed - Start development server:
composer run dev
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
This software is distributed under the GNU General Public License version 3.0, which grants users significant freedoms while ensuring the preservation of software freedom for all recipients.
Permitted Uses:
- Unrestricted Usage Rights: The software may be used for any lawful purpose, including personal, commercial, educational, and research applications
- Source Code Access: Full access to source code is guaranteed, enabling study and analysis of the program's functionality
- Distribution Rights: Users are authorized to distribute verbatim copies of the software to third parties
- Modification Rights: The software may be modified, adapted, and improved according to user requirements
- Commercial Distribution: Users may charge fees for distribution, support services, or warranty provisions
Distribution Obligations:
- Source Code Provision: Any distribution of the software, whether modified or unmodified, must include access to the complete corresponding source code
- License Preservation: All distributions must include a copy of the GPL v3 license and maintain all copyright notices
- Copyright Attribution: The original authors' names and copyright statements must remain visible and intact in the code
- Modification Documentation: Modified versions must be clearly marked with notices indicating the nature and date of changes
- Copyleft Requirement: All derivative works must be licensed under the same GPL v3 terms, ensuring continued software freedom
Legal Limitations:
- Warranty Disclaimer: The software is provided "as is" without warranties of merchantability, fitness for purpose, or freedom from defects
- Liability Limitation: Contributors and distributors are not liable for damages arising from use of the software
- Proprietary Integration Prohibition: The software cannot be incorporated into proprietary programs or combined with incompatible licenses
- Additional Restriction Prohibition: No further restrictions may be imposed on the exercise of rights granted by this license
For the complete legal text, see the LICENSE file.
Contributions are welcome! Please ensure that any contributions are compatible with the GPL v3 license terms.
For support and questions related to the EFSU Portal, please contact the Engineering Faculty Students' Union at the University of Moratuwa.
Original Authors:
© 2025 Engineering Faculty Students' Union, University of Moratuwa