No description
| .gemini | ||
| .github | ||
| .woodpecker | ||
| app | ||
| bootstrap | ||
| cmd | ||
| config | ||
| database | ||
| docker | ||
| docs | ||
| nginx/conf.d | ||
| public | ||
| resources | ||
| routes | ||
| storage | ||
| tests | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.dusk.local.example | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| artisan | ||
| boost.json | ||
| CHANGELOG.md | ||
| composer.json | ||
| composer.lock | ||
| Dockerfile | ||
| GEMINI.md | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| phpunit.xml | ||
| README.md | ||
| vite.config.js | ||
share-lt
Share Light CMS - Headless CMS with Real-time Publishing
Overview
Share Light is a modern headless CMS built with Laravel 12 that enables real-time content management and automated static site generation. It provides a complete backend solution for content creators and developers who need a robust, scalable CMS with live preview capabilities.
Architecture
This application runs as a fat container orchestrated by tini and supervisor, managing multiple services:
- Laravel 12 - Core CMS application with Filament admin interface
- PHP-FPM - PHP process manager
- nginx - Web server and reverse proxy
- Queue Worker - Background job processing
- Laravel Reverb - WebSocket server for real-time communication
Integration with External Services
- NATS Messaging - Publishes messages to NATS streams when content changes
- share-lt-astro-consumer - Companion application that consumes NATS messages to rebuild static sites
- Real-time Notifications - Uses Reverb to send toast alerts to users about build status
Features
Content Management
- Entry Model - Core content entities with media library support
- Text Widgets - Reusable content blocks
- Categories - Content organization and taxonomy
- Media Library - Image and file management with Spatie Media Library
Real-time Publishing Workflow
- Content Updates - When entries are modified, messages are automatically sent to NATS streams
- Consumer Notifications - External applications (like share-lt-astro-consumer) listen for these messages
- Preview Generation - Consumers rebuild preview websites based on content changes
- Status Updates - Build results are sent back via API
- Live Alerts - Users receive real-time toast notifications about build status through Reverb
API & Integration
- RESTful API - Complete API for content retrieval and management
- Access Control - Built-in authorization and authentication
- NATS Integration - Message streaming for distributed architecture
this project is in 'Alpha'
it is published as "R&D", open source, GNU AFFERO GENERAL PUBLIC V3
default branch is currently dev
main will be used as the project becomes stable
for changes, see CHANGELOG
architecture decision records (ADRs) will be numbered over time.