Skip to content

Repository files navigation

Portal Project

Overview

A modular web portal built with Laravel 11, designed to host multiple applications with robust authentication, role-based access control, and flexible module architecture.

Version

Current Version: 0.2.0

What's New in 0.2.0

  • Unified, responsive navigation system
  • Dashboard link with icon in navigation
  • Enhanced layout flexibility
  • Support for multiple content rendering methods

Documentation

Detailed documentation can be found in the docs/ directory:

  • ROADMAP: Project vision and long-term goals
  • TODO: Current tasks and progress tracking
  • ARCHITECTURE: System design and technical details
  • MODULES: Guide for module development
  • SECURITY: Security considerations and practices
  • CHANGELOG: Detailed version history

Key Features

  • Modular application architecture
  • Comprehensive authentication system
  • Role-based access control
  • Audit logging
  • Flexible UI support
    • Blade components
    • Traditional Blade views
    • Livewire components
    • Alpine.js interactions
  • Mobile-responsive design
  • Customizable navigation

Layout Rendering Methods

Portal supports multiple content rendering methods:

  1. Blade Component $slot:
<x-app-layout>
    <!-- Content here -->
</x-app-layout>
  1. Blade Component $content:
<x-app-layout>
    <x-slot:content>
        <!-- Content here -->
    </x-slot:content>
</x-app-layout>
  1. Traditional Blade @yield('content'):
@extends('layouts.app')

@section('content')
    <!-- Content here -->
@endsection

Installation

Prerequisites

  • PHP 8.1+
  • Composer
  • Node.js and npm

Steps

  1. Clone the repository
git clone https://github.com/yourusername/portal.git
cd portal
  1. Install PHP dependencies
composer install
  1. Install JavaScript dependencies
npm install
npm run dev
  1. Copy environment file and generate key
cp .env.example .env
php artisan key:generate
  1. Configure your database in .env

  2. Run migrations

php artisan migrate

Running the Application

php artisan serve

Contributing

Please read our CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages