Download the PHP package baconfy/prompt without Composer

Manage AI prompts in Laravel as Markdown files (with optional YAML front matter) or database records, rendered through Blade.

Why

LLM prompts are configuration. They drift across the codebase, get duplicated, and end up hardcoded as long strings inside services. This package treats prompts as first-class assets:

• One file or DB record per prompt
• YAML front matter for model/temperature/required variables
• Blade rendering for variable interpolation
• Drivers for file and database storage
• Strict validation of required variables

Requirements

• PHP 8.3+
• Laravel 12+

Installation

The service provider auto-registers. Publish what you need:

Quick start

Create a prompt at resources/prompts/welcome.md:

Render it:

Use the metadata to drive your LLM call:

Front matter

Front matter is an optional YAML block at the top of the prompt:

Behavior:

• If the file does not start with ---, it is treated as plain content (no metadata, no validation, just Blade).
• required: [...] is enforced. Missing variables throw MissingRequiredVariablesException.
• Anything else is metadata. The package does not interpret it; read it via $prompt->metadata['anything'].

Drivers

File driver

Default. Reads from resources/prompts/*.md. Dot notation maps to subfolders:

Database driver

Stores prompts in a prompts table with name and content columns. The content column holds raw markdown — exactly the same format as the file driver. Front matter, when present, sits inline at the top of content.

Migrating prompts between file and database drivers is a copy/paste — the storage format is identical.

Switch the default driver in .env:

Or use both side by side:

API

Helper

Facade

RenderedPrompt

ParsedFrontMatter

What Prompt::source() returns — pre-render. Useful when you want metadata without rendering Blade:

Prompt model

Eloquent model on the prompts table. Use it to seed, update, or otherwise manage DB-backed prompts:

The driver itself does not depend on this model — it reads via Query Builder. The model is a convenience for your CRUD layer.

CLI

Three Artisan commands ship with the package:

prompt:list accepts an optional driver argument (the name of any driver defined in config/prompt.php); omitting it iterates all drivers. prompt:show accepts a --driver= option to target a specific named driver instead of the active default. prompt:make is file-driver only — database prompts are created directly via the prompts table.

prompt:show is your debug companion: confirm what Prompt::source('welcome') will return before rendering anywhere.

Testing

Faking prompts

In your application's tests, replace the real driver with a stub so prompts don't hit the filesystem or database:

A plain string stub is wrapped in a RenderedPrompt with empty metadata; pass a RenderedPrompt instance when your code reads $prompt->metadata.

Factories

The Prompt model ships with an Eloquent factory for seeding test data when you use the database driver:

Configuration

config/prompt.php:

The drivers array supports any number of named entries. Each one has a driver field (file or database) plus the keys that driver needs. The same type can appear under multiple names (e.g. two file folders for system vs. user prompts).

Exceptions

• PromptNotFoundException — thrown by Prompt::get() when the name is not found by the active driver. Exposes ->name.
• MissingRequiredVariablesException — thrown when the prompt declares required in its metadata and any variable is missing from $data. Exposes ->variables (the list of missing names).

Admin Panel

Optional admin panel for managing prompts stored in the database driver. The file driver remains read-only and is meant to be managed via Git.

The panel ships as plain Blade views styled with Tailwind via CDN — no front-end build step, no JavaScript framework, no extra dependencies. Routes are mounted at /_prompts by default whenever prompt.panel.enabled is true.

Authorization

Two equivalent options (the callback wins if both are present):

If neither is defined, the panel responds 403.

Features

• Index at /_prompts — paginated list of every prompt name (latest version per name) with a vN badge and live search.
• Editor at /_prompts/create and /_prompts/{prompt}/edit — form with live preview that renders the prompt through Blade using JSON variables. Refuses to save if the content is identical to the current latest version.
• Versions at /_prompts/{prompt}/versions — accordion of every revision with a unified diff against the current version. Each older row can be Restored (creates a new version on top with the chosen content) or Deleted.

Versioning model

Every save inserts a new row in the prompts table; existing rows are never updated. Rows sharing a name form a version chain:

• First save → new row with root_id = null (the root, v1).
• Subsequent saves → new row with root_id pointing to the v1 row.
• Prompt::get('welcome') always resolves to the latest version (MAX(id) per name).

Configuration

Publish the views to customize them:

Security

Blade compiles prompt content. Do not load prompt content from untrusted sources. A prompt containing {{ system('rm -rf /') }} would execute that PHP if rendered. Treat prompts as code, not user input.

The panel is gated by Panel::auth() / Gate and ships behind the web middleware group by default — it is not safe to expose publicly without authorization.

Development

Run the package test suite:

Boot a local dev environment (Orchestra Testbench workbench + SQLite):

The workbench wires Panel::auth() to always allow, so / redirects to /_prompts ready to use.

Credits

• Renato Dehnhardt
• All contributors

License

See LICENSE for details.