openclassify/openclassify

The skeleton application for the Laravel framework.

Maintainers

Package info

github.com/openclassify/openclassify

Type:project

pkg:composer/openclassify/openclassify

Statistics

Installs: 2 515

Dependents: 0

Suggesters: 0

Stars: 298

Open Issues: 0


README

OpenClassify is a modular classifieds marketplace built with Laravel 12 and Filament v5.

Core Stack

  • Laravel 12
  • FilamentPHP v5
  • nwidart/laravel-modules
  • Blade + Tailwind + Vite
  • Spatie Permission
  • Laravel Reverb + Echo (realtime chat)

Modules

All business features live in Modules/* (routes, services, models, resources, views, seeders).

Create a new module:

php artisan module:make ModuleName

Enable it in modules_statuses.json.

Quick Start

Docker

cp .env.example .env
docker compose up -d

App URLs:

  • Frontend: http://localhost:8000
  • Admin: http://localhost:8000/admin
  • Panel: http://localhost:8000/panel

Local

Requirements: PHP 8.2+, Composer, Node 18+, database server.

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan db:seed
composer run dev

Seeded Accounts

Role Email Password
Admin a@a.com 236330
Member b@b.com 36330

Demo Mode

Demo mode provisions a temporary, per-visitor marketplace schema.

Requirements:

  • DB_CONNECTION=pgsql
  • DEMO=1

Minimal .env:

DEMO=1
DEMO_TTL_MINUTES=360
DEMO_SCHEMA_PREFIX=demo_
DEMO_COOKIE_NAME=oc2_demo
DEMO_LOGIN_EMAIL=a@a.com
DEMO_PUBLIC_SCHEMA=public

Commands:

php artisan demo:prepare
php artisan demo:cleanup

Notes:

  • First guest homepage shows only Prepare Demo.
  • Prepare Demo creates/reuses a private schema and logs in seeded admin.
  • Expired demos are cleaned up automatically (hourly schedule).

Realtime Chat (Reverb)

Set .env:

BROADCAST_CONNECTION=reverb
REVERB_APP_ID=app_id
REVERB_APP_KEY=app_key
REVERB_APP_SECRET=app_secret
REVERB_HOST=localhost
REVERB_PORT=8080
REVERB_SCHEME=http
REVERB_SERVER_HOST=0.0.0.0
REVERB_SERVER_PORT=8080
VITE_REVERB_APP_KEY="${REVERB_APP_KEY}"
VITE_REVERB_HOST="${REVERB_HOST}"
VITE_REVERB_PORT="${REVERB_PORT}"
VITE_REVERB_SCHEME="${REVERB_SCHEME}"

Start:

composer run dev

Channel strategy:

  • private channel: users.{id}.inbox
  • events: InboxMessageCreated, ConversationReadUpdated

Test and Build

php artisan test
php artisan optimize:clear
php artisan view:cache

Production Checklist

php artisan migrate --force
php artisan db:seed --force
php artisan storage:link
php artisan config:cache
php artisan route:cache
php artisan view:cache

Contributors