Skip to Content
Housr PortalOverview

Housr Portal

Internal admin portal for managing the Housr platform. Built with Laravel 11, Filament 4, and Livewire 3.

Overview

The Portal serves four user types through separate panel interfaces:

PanelPathUsersPurpose
Admin (Legacy)/admin/*Housr staff (usertype 1) + internal usersFull platform management
Admin (Filament)/internal-adminSame as aboveModern Filament-based admin UI
Landlord/* (root)Property owners/agents (usertype 2, 7)House management, enquiries, contracts
Moderator/moderator/*Moderators, managers, admins (usertype 4, 5, 6, 7, 9)Student moderation, issues, performance
B2B/dashboardB2B partners (usertype 8)Partner dashboard, referrals, commissions

The Portal shares its MySQL database with Housr API v1 and API v2 — all three applications read and write the same tables.

Quick Start

# Install dependencies
composer install
npm install
 
# Copy environment file
cp .env.example .env
php artisan key:generate
 
# Run dev server (PHP + Vite + log tail in parallel)
composer dev

This starts:

  • PHP dev server on localhost:8001
  • Vite HMR on localhost:5173
  • Log tail on storage/logs/laravel.log

Key Commands

composer dev              # Start all dev processes (server + vite + logs)
php artisan serve --port=8001   # PHP dev server only
npm run dev               # Vite dev server only
npm run build             # Production Vite build
php artisan filament:upgrade    # Rebuild Filament assets after updates

Tech Stack

  • PHP 8.2+ / Laravel 11
  • Filament 4 (admin panel framework, /internal-admin)
  • Livewire 3 (legacy panels use Livewire components directly)
  • Vite with SCSS + Bootstrap 5
  • MySQL (shared with API v1/v2)
  • AWS S3 for file storage (public images, agent documents, misc)
  • Firebase Realtime Database for chat
  • Sentry for error tracking

Documentation Index

  • Architecture — Laravel + Filament + Livewire structure
  • Setup — Installation and environment configuration
  • Auth — Authentication and role-based access
  • Filament Resources — Building Filament resources
  • Models — Key Eloquent models
  • Database — Shared database architecture
  • Deployment — Docker, Nginx, production builds

Panel Docs

Service Integrations

Last updated on
DeploymentSetup