Getting Started
Prezet Installation Guide
This guide will walk you through the process of installing Prezet, a powerful markdown blogging framework for Laravel. Follow these steps to set up your project and start creating SEO-friendly blogs, articles, and documentation.
#Step 1: Install the Prezet Framework
Install the core Prezet framework package using Composer:
1composer require prezet/prezet:^1.0.0@rc
#Step 2: Run the Framework Installer
Run the Prezet framework installer using the following Artisan command:
1php artisan prezet:install
This command sets up the core Prezet functionality, including configuration and necessary service providers.
#Step 3: Install a Frontend Template
The Prezet framework provides the backend engine. You'll need to install a separate template package to provide the frontend (routes, controllers, views, CSS).
Here's an example using the Official Docs Template (github.com/prezet/docs-template):
1# Install the template package2composer require prezet/docs-template --dev3 4# Run the template's installer5php artisan docs-template:install
Existing Configuration Files
The template installer might overwrite existing files like vite.config.js and postcss.config.js. Ensure you have backups before proceeding if you have customized these files.
#Step 4: Start Your Server
Once the installation is complete, you can start your Laravel development server:
1php artisan serve
After starting your server, you can verify the installation by visiting:
You should now see your new markdown blog powered by Prezet!
#Step 5: Generate the SQLite Index
After installing Prezet and setting up your initial content, it's important to generate the SQLite index. Run the following Artisan command to create and populate the index:
1php artisan prezet:index --fresh
For more information about the SQLite index and its purposes, refer to the Prezet SQLite Index documentation.
#Next Steps
With Prezet installed, you're ready to start creating content and customizing your blog. Check out the other documentation pages to learn more about:
- Writing markdown content
- Using Blade components in your markdown
- Optimizing images
- Customizing routes, front matter, and more
Hope you enjoy blogging with Prezet!