PHPackages antonioprimera/laravel-site - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. antonioprimera/laravel-site ActiveLibrary[Templating & Views](/categories/templating) antonioprimera/laravel-site =========================== A foundation to build Websites using Laravel, including reusable view components. v1.1.11(1y ago)0571MITPHPPHP ^8.2 Since Aug 28Pushed 1y ago1 watchersCompare [ Source](https://github.com/AntonioPrimera/laravel-site)[ Packagist](https://packagist.org/packages/antonioprimera/laravel-site)[ Docs](https://github.com/antonioprimera/laravel-site)[ GitHub Sponsors](https://github.com/AntonioPrimera)[ RSS](/packages/antonioprimera-laravel-site/feed)WikiDiscussions master Synced 2d ago READMEChangelog (10)Dependencies (10)Versions (19)Used By (1) A foundation to build configurable Websites using Laravel ========================================================= [](#a-foundation-to-build-configurable-websites-using-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/9ea8716e2389b707468b9a9ac9487cb423c8f534408b10a6b7c9ca57d22bb3c8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e746f6e696f7072696d6572612f6c61726176656c2d736974652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/antonioprimera/laravel-site) This package provides the basic building blocks to create a configurable website using Laravel and Filament as the admin panel, where you can maintain the text and images of your website. It provides the following models: - Site: A Site is a collection of Pages and holds a settings container, that can be used to store global settings for the site. - Page: A Page is a collection of Sections - Section: A Section is a collection of Bits - Bit: A Bit is a data container, that can be used to store parts of site sections. All models have a `uid` attribute, used to identify and retrieve the models. The `uid` is a string that should be unique within the model type. For example, in order to identify a model, you would use the Site Facade or the helpers: ``` //gets the 'default' site $site = site(); //gets the 'home' page of the 'default' site $page = page('home'); //gets the 'hero' section of the 'home' page of the 'default' site $section = section('home:hero'); //gets the 'cta' bit of the 'hero' section of the 'home' page of the 'default' site $bit = bit('home:hero.cta'); //if you have several sites, you can specify the site key as the first argument for all the helpers $bit = bit('my-site/home:hero.cta'); ``` The Section and the Bit models have a single spatie media 'image', so you can easily associate images with them. ``` //setting the image of a section section('home:hero')->setImageFromMediaCatalog('path/to/image.webp'); //retrieving the image of a section $mediaInstance = section('home:hero')->image; ``` This package provides abstract classes for building Page, Section and Bit View Components, that can be used to render the models in your views. You can extend these classes to create your own View Components. You can use the following bash commands to generate new View Components: ``` #generates a new Page View Component and a data migration if the -m flag is set php artisan site:page AboutUs -m #generates a new Section View Component php artisan site:section Hero #generates a new Bit View Component php artisan site:bit Cta ``` Additionally, you can use the [antonioprimera/laravel-site-components](https://github.com/AntonioPrimera/laravel-site-components)package to get some pre-built components and artisan commands to create new View Components for Sections and Bits. The models use `spatie/laravel-medialibrary` to store images and `spatie/laravel-translatable` to make the title and contents translatable. Installation ------------ [](#installation) You can install the package via composer: ``` composer require antonioprimera/laravel-site ``` Publish the migrations and run them: ``` php artisan vendor:publish --tag="site-migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --tag="site-config" ``` This is the contents of the published config file: ``` return [ /** * The list of locales that should be used for translations * Make sure to include the default and fallback locale in this list */ 'translations' => [ 'locales' => ['en'], 'missing-translation' => '--', //the string that should be displayed if a translation is missing ], /** * Site section view component default configuration */ 'sections' => [ //section images will be resized to fit these dimensions 'image' => [ 'max-width' => 1920, 'max-height' => 1080, ], ], /** * Data migrations configuration */ 'data-migrations' => [ //the path to the directory where site data migrations are stored, relative to the database directory 'path' => 'site-migrations', ], 'model-builders' => [ //whether the model builders should automatically save the model after each fluent method call //e.g. calling $builder->withName('test') will automatically save the model if this is set to true 'fluent-auto-save' => true, ], /** * Media catalog configuration */ 'media-catalog' => [ //the disk where media catalog files are stored 'disk' => 'media-catalog', ], 'views' => [ //the root path for the blade views of the site components (relative to the resources/views directory) 'bladeRootName' => 'components', //the namespace of the site components 'componentNamespace' => 'App\\View\\Components\\', ], //settings for the generator commands: site:page, site:section, site:bit 'generator-command' => [ 'pages' => [ 'rootNamespace' => 'App\\View\\Components\\Pages', 'classTargetFolder' => 'View/Components/Pages', //relative to the project root 'bladeTargetFolder' => 'components/pages', //relative to the resources/views directory ], 'sections' => [ 'rootNamespace' => 'App\\View\\Components\\Sections', 'classTargetFolder' => 'View/Components/Sections', 'bladeTargetFolder' => 'components/sections', ], 'bits' => [ 'rootNamespace' => 'App\\View\\Components\\Bits', 'classTargetFolder' => 'View/Components/Bits', 'bladeTargetFolder' => 'components/bits', ], ] ]; ``` Usage ----- [](#usage) The package offers the following main features: - Site, Page, Section and Bit models, to store and retrieve the data for your website - View Component generators for Pages, Sections and Bits, so you can easily create new View Components and use the models in your views - Data migrations, to seed the database with site data (Site, Pages, Sections and Bits using the SiteBuilder, PageBuilder, SectionBuilder and BitBuilder classes) - Site Facade and helper functions to retrieve the models by their uid and to handle the site locales ### Create new data migrations [](#create-new-data-migrations) These migration files are stored in the `database/site-migrations` directory and can are run using the `artisan migrate`together with your standard laravel migrations. ``` php artisan site:migration CreateHomePage ``` You can use the `SiteBuilder`, `PageBuilder`, `SectionBuilder` and `BitBuilder` classes to create new models in your data migrations, which provide a fluent interface to create, update and delete the models. Here's an example of a data migration file, which creates a Site, a Page and a Section model with 2 Bit models attached to it: ``` use AntonioPrimera\Site\Database\DataMigration; use AntonioPrimera\Site\Database\ModelBuilders\SiteBuilder; use AntonioPrimera\Site\Database\ModelBuilders\PageBuilder; use AntonioPrimera\Site\Database\ModelBuilders\SectionBuilder; use AntonioPrimera\Site\Database\ModelBuilders\BitBuilder; return new class extends DataMigration { public function up(): void { //if this is the first migration, you should create the site first SiteBuilder::create('default', 'My Personal Branding Site') ->withData([ 'logo' => 'path/to/logo.webp', 'favicon' => 'path/to/favicon.webp', 'socialMedia' => [ 'facebook' => 'https://facebook.com/my-profile', 'instagram' => 'https://instagram.com/my-profile', 'x' => 'https://x.com/my-profile', ], ]); //create the home page PageBuilder::create( uid: 'home', name: 'Home Page', title: 'My Home Page', short: 'This is my presentation home page', route: 'home', menuLabel: 'Home', menuVisible: true, menuPosition: 1, data: [ 'seo' => [ 'title' => 'My Home Page', 'description' => 'This is the description of my home page', 'keywords' => 'home, page, website', ], ] ); SectionBuilder::create(page: 'home', uid: 'hero', name: 'Home Hero Section') ->withTitle(['en' => 'Welcome to our website', 'de' => 'Willkommen auf unserer Webseite']) ->withContents(['en' => 'This is the hero section of the home page', 'de' => 'Dies ist der Hero-Bereich der Startseite']) ->withImageFromMediaCatalog('path/to/home-hero-image.webp') ->createBit( uid: 'cta', title: ['en' => 'Contact us', 'de' => 'Kontaktiere uns'], data: ['url' => '/contact', 'icon' => 'heroicon-o-phone'], build: fn(BitBuilder $builder) => $builder->withImageFromMediaCatalog('path/to/cta-background-image.webp', 'cta image alt text') ) ->createBit( uid: 'motto', build: fn(BitBuilder $builder) => $builder->withTitle(['en' => 'Our Motto', 'de' => 'Unser Motto']) ->withContents(['en' => 'This is our motto', 'de' => 'Das ist unser Motto']) ->withImageFromMediaCatalog('path/to/motto-side-image.webp', 'our motto image alt text') ); } public function down(): void { SectionBuilder::delete('home:hero'); } }; ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 30 — LowBetter than 62% of packages Maintenance33 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community9 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 18 Last Release 670d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/77cac31fc31444fb45ef19e3628a7b243b5456679a9e6db635aa3b979bfdbefc?d=identicon)[AntonioPrimera](/maintainers/AntonioPrimera) --- Top Contributors [![AntonioPrimera](https://avatars.githubusercontent.com/u/23128666?v=4)](https://github.com/AntonioPrimera "AntonioPrimera (30 commits)") --- Tags laravelantonioprimeralaravel-site ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/antonioprimera-laravel-site/health.svg) ``` [![Health](https://phpackages.com/badges/antonioprimera-laravel-site/health.svg)](https://phpackages.com/packages/antonioprimera-laravel-site) ``` ### Alternatives [statikbe/laravel-filament-flexible-content-blocks The Laravel Filament Flexible Content Blocks package helps you to easily create content in Filament for any model, with predefined or custom blocks, and foreach block an extendable Blade view component. 17625.6k4](/packages/statikbe-laravel-filament-flexible-content-blocks)[nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[slimani/filament-media-manager A media manager plugin for Filament. 126.9k](/packages/slimani-filament-media-manager)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 284.5k1](/packages/finity-labs-fin-mail)[tapp/filament-form-builder User facing form builder using Filament components 132.4k3](/packages/tapp-filament-form-builder) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)