benbjurstrom/prezet

Prezet: Markdown Blogging for Laravel

v1.0.0-rc6 2025-02-26 18:13 UTC

Requires

• php: ^8.2
• ext-dom: *
• ext-gd: *
• benbjurstrom/laravel-sitemap-lite: ^7.3.1
• illuminate/contracts: ^10.0||^11.0||^12.0
• league/commonmark: ^2.6.1
• spatie/laravel-package-tools: ^1.16
• symfony/yaml: ^6.2|^7.1
• wendelladriel/laravel-validated-dto: ^4.0

Requires (Dev)

• larastan/larastan: 2.9.8
• laravel/pint: ^1.20
• nunomaduro/collision: ^8.6
• orchestra/testbench: ^9.9
• pestphp/pest: ^3.7
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.1
• phpstan/extension-installer: ^1.4.3
• phpstan/phpstan: 1.12.2
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-phpunit: 1.4.2
• spatie/browsershot: ^4.0

MIT

• Ben Bjurstrom

• laravel
• prezet

README

Prezet: Markdown Blogging for Laravel

Go from markdown files to SEO-friendly blogs, articles, and documentation in seconds! The Prezet framework makes it easy to parse, index, and serve your Markdown content efficiently within a Laravel application.

(Looking for a ready-to-use frontend? Check out template packages like prezet/docs-template!)

Table of Contents

• Framework Features
• Quick Start
• Documentation

✨ Framework Features

• SQLite Index

Indexes your markdown files to support search, pagination, sorting, and filtering.

• Automatic Image Optimization

Handles image processing, including compression, scaling, and generating responsive `srcset` attributes.

• Validated Front Matter

Define expected front matter fields and automatically cast them into validated Data Transfer Objects (DTOs) for type-safe access in your application.

• Open Graph (OG) images

Generate OG images from front matter using a customizable template.

• Dynamic Table of Contents

Automatically extracts headings from your Markdown content to generate data for a nested Table of Contents.

• SEO Optimization

Automatically generate meta tags based on front matter data for better search engine discoverability.

• Blade Components

Include Laravel Blade components in your markdown for enriched, interactive content.

🚀 Quick Start

1. Install the Prezet framework:

   # Install the framework package
   composer require prezet/prezet:^1.0
   
   # Run the framework installer
   php artisan prezet:install

2. Install a Frontend Template:

   The Prezet framework provides the backend engine. A template package provides the frontend (routes, controllers, views, CSS).

   Example using the Official Docs Template:

   # Install the template package
   composer require prezet/docs-template --dev
   
   # Run the template's installer
   php artisan docs-template:install

3. Index Your Content: After adding or modifying Markdown files in your content directory update the Prezet index:

   php artisan prezet:index --fresh

   This command scans your content directory and updates the SQLite index with the latest front matter information. Run this whenever you:

   • Add new Markdown files.
   • Change a file's slug (filename).
   • Modify front matter and need it reflected in listings or searches. (Changes to the main body content of Markdown files are reflected automatically when viewing a single page).

4. Start Your Server:

   php artisan serve

   Visit the routes defined by your installed frontend template (e.g., /prezet if using prezet/docs-template).

Documentation

Detailed documentation is available at prezet.com

Credits

• Ben Bjurstrom
• All Contributors

License

The MIT License (MIT). Please see License File for more information.