README

Synapse — App Builder

A data-driven app builder that lives inside your own Laravel + Filament admin.
Visual pages, typed data + an instant REST API, an n8n-style flow engine, end-user auth (SSO/2FA) and external data — configurable on the fly. Drops into an existing Laravel app as a package and lives alongside it, no clash. AI is an optional accelerator that builds and refines for you. Free, MIT, entirely self-hosted.

Website · Documentation · Quick start · What you can build · The AI layer

Why Synapse

Building an internal tool, a SaaS UI, or a marketing site usually means stitching together a CMS, a database admin, a workflow tool, an auth system and a front-end — then wiring them all up by hand.

Synapse is all of that, in one package, inside the Laravel + Filament admin you already run. Drag pages together, define your own data tables, wire automations that react to clicks and data changes, gate it behind your own users and roles — and when you'd rather just say what you want, the built-in AI generates the whole thing and keeps refining it as you chat.

It lives alongside your existing app. Synapse is a package, not a platform: its tables are prefixed (page_builder_* / pb_<key>), it registers its own end-user auth guard without touching yours, its admin UI is an opt-in Filament plugin, and its routes defer to your app's (it never claims /). Drop it into a Laravel app you already run and it coexists — no clash, fully configurable (connection, table names, guard, routes, models are all overridable).

Nothing leaves your server. There's no SaaS, no per-seat pricing, no lock-in. It's MIT-licensed and yours.

You bring the idea. Synapse brings the pages, the database, the logic, the login screen — and an optional AI that builds alongside you.

What's inside

See it

Everything below was built with the package itself — run php artisan ai-page-builder:install-demo to get the marketing site and the role-gated Inventory app, then sign in and explore.

A designed marketing site	A role-gated Inventory app — live data, KPIs, search & CRUD

The visual builder — drag typed, colour-coded blocks	The flow canvas — colour-coded nodes + true / false branches

Describe it; AI returns a reviewable Build Plan	The app's own sign-in (password · SSO · 2FA)

What you can build

• An internal CRUD tool — define collections, use the management page pattern (Add form + data table + per-row Edit/Delete), gate it behind a login with per-role, row-level access (users see only their own rows). Relation columns resolve names automatically.
• A lead-capture or feedback site — a public page whose form writes straight into a collection, with a flow that emails a templated confirmation on every submission.
• A reactive dashboard — components bound to live state, updated by flows as data changes, no page reload.
• A marketing site — pick a home page, design freely, publish to a cached route.
• …or just describe it — "a waitlist app that emails a welcome on signup and has a landing page" → Synapse builds the collection, the page, the email template and the flow, and you tweak it from the chat.

How it fits together

The loop in one line: event → flow → read/write data + set state → bound components re-render — and AI can build or change any of it.

Quick start

Requirements: PHP 8.2+ · Laravel 11/12/13 · Filament 4/5

composer require andrecorugda/synapse
php artisan vendor:publish --tag="ai-page-builder-migrations"
php artisan migrate

Register the plugin on your Filament panel:

use Andre\AiPageBuilder\Filament\AiPageBuilderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel->plugin(AiPageBuilderPlugin::make());
}

Then say who may build apps — Synapse is closed to everyone until you do. In your AppServiceProvider::boot():

use Illuminate\Support\Facades\Gate;

Gate::define('synapse.admin', fn ($user) => $user->is_admin);

A Content group appears with Pages, Media, Flows, Functions, Collections, States, App Users, Roles and Settings. Create a collection, build a page, wire a flow, publish.

Access control. Only users who pass synapse.admin see the Synapse screens and can use the AI chat, media upload and lint endpoints. Credentials, users, code, settings and external data sources have finer abilities that follow a Gate::defined synapse.admin unless you define them (with spatie/laravel-permission, grant each one as a permission). See Builder admins — who can open Synapse. Upgrading from 1.x? Read UPGRADE.md.

To unlock AI generation, install the gateway and add your OpenRouter key — the app_builder integration self-seeds:

composer require andrecorugda/ai-openrouter-gateway
# set OPENROUTER_INTEGRATION_KEY (or OPENROUTER_API_KEY) in .env

Then tap the ✦ chat orb on any admin page and just talk to it.

Want a guided tour? Install two ready-made apps (a marketing site + a role-gated Inventory CRUD app) built entirely from the package:

php artisan ai-page-builder:install-demo

📖 Full documentation: docs/ — installation, architecture, every subsystem, and the complete config reference.

The AI layer

AI is optional and additive — the builder is fully usable by hand. When the AI OpenRouter Gateway is installed:

• A real conversation, with modes. The floating chat talks like a teammate — Auto infers what you want, Ask answers only, Plan designs it with you, Build ships it. Greetings and questions get replies, not plans.
• You describe; it plans — visibly. When you ask for a change, it returns a structured Build Plan shown in full (each collection + its fields, pages, flows, settings) for review — never opaque files.
• Applied as data. A deterministic, idempotent engine writes the plan through the same services the admin uses, so AI-built artifacts behave exactly like hand-built ones — and "refine" just means re-applying a plan that references existing items.
• A companion, not a wizard. The chat is thread-aware and context-aware (it knows your collections, pages and flows); build on one page, refine on another.
• Safe by construction. AI-authored HTML is sanitized (declarative bindings kept, executable directives stripped); applying is always human-in-the-loop; generation is metered and cost-capped by the gateway.

Self-hosting front-end assets (offline / air-gapped)

The editor loads GrapesJS, Drawflow, Alpine and Ace from a CDN by default (zero-config). For offline / strict-CSP installs, vendored copies ship in the box:

php artisan vendor:publish --tag="ai-page-builder-assets"
# → public/vendor/ai-page-builder/{grapesjs,drawflow,alpine,ace}/

Point the asset env vars at the published copies (see docs/installation.md). AI_PAGE_BUILDER_ACE_BASE must stay a directory.

Testing & quality

composer test       # Pest
composer lint       # Pint
composer analyse    # PHPStan (larastan)

Support

Synapse is free and MIT-licensed. If it's useful to you, you can support its development:

License

MIT © Andre Corugda. See LICENSE.