Synapse App Builder

• Pick your path
• All pages
• Conventions used in these docs

Synapse is a self-hosted, low-code app builder that lives inside the Laravel + Filament admin you already run. You build pages (GrapesJS), define your own data tables (Collections), wire automations (Flows), gate everything behind your app's own users and roles — and an optional AI layer can generate or refine the whole thing from a plain-language brief. Everything you build is stored as ordinary database rows, and nothing leaves your server.

These docs are the reference: how it installs, how each subsystem works, the exact config keys, routes, table names, field types, node shapes and query syntax — grounded in the package source.

#Pick your path

No-code / app author — you live in the Filament admin and want to ship an app:

1. Installation — get the panel plugin running.
2. Architecture — the mental model in five minutes.
3. Pages & components — build and publish pages.
4. Collections & data — your own data tables.
5. Flows — make things happen on clicks and data events (including atomic transaction + loop automations).
6. AI — describe an app, review the plan, apply it, refine by chat.

Developer / integrator — you embed Synapse in a host app, extend it, or self-host its assets:

1. Installation and Configuration — full env + config reference.
2. Architecture — services, models, the request lifecycle.
3. Functions & States — runtimes, the eval-free helper library, the reactive store.
4. Authentication & permissions — the pb guard, opt-in permission model, row-level rules.
5. Email — the isolated SMTP transport and templates.
6. Extending — swap models, register custom flow nodes/blocks, the AiInvoker contract, observers.
7. Extending flow nodes & helpers — the PageBuilder::registerNode/registerHelper seam, the capability catalogue, MCP/AI exposure.

#All pages

#Conventions used in these docs

• Collection = a user-defined data model (a real DB table named pb_<key>).
• State = a persistent, app-wide global variable (the reactive store; the Filament resource is labelled "States," the model is Variable).
• Flow = an automation graph; Function = a reusable unit of logic a flow can call.
• Built app vs host app: the host is your Laravel application; the built app is what you author with Synapse (its pages, data and its own pb-guard users).