Skip to content
Laravel Truss

Quick start

By default Truss is enabled in the local environment only. Start your app and open /truss (the prefix is configurable). You will see your schema as an ER diagram: each table is an entity box with its columns, native types, and PK / FK badges, and foreign keys are drawn as crow’s-foot relationships.

Try it live

The frame below runs the real Truss frontend on a fictional sample schema, so you can try everything on this page without installing anything. Drag to pan, scroll or pinch to zoom, and click a table name to focus or export it.

Open the demo in its own tab for more room. It contains structure only, no real data (there is none).

Moving around

The diagram behaves like a map:

  • Pan by dragging.
  • Zoom by scrolling, pinching (on touch), or using the zoom slider.
  • Fit frames the whole diagram in one click. Auto-fit also runs whenever the content changes, never below a readable zoom, so a large schema stays legible and you pan around it.

Filtering and focusing

  • Filter narrows the diagram to tables whose name matches what you type.
  • Focus reduces the diagram to one table and its foreign-key neighbours, up to a configurable depth. The focused table is centred and highlighted. This is the main tool for keeping large schemas readable.

Filter and focus compose: focus operates on whatever the filter left in.

Your current view is reflected in the URL (for example /truss?focus=projects), so you can bookmark or share a focused or filtered view and it reopens in that state.

Reading the diagram

  • Type labels show the native database type (for example varchar(255)) by default. Toggle Laravel types to see best-effort short labels (for example string).
  • enum / set columns are compacted to the keyword so a long value list does not blow out the column. Click the enum label to see the full list of allowed values.
  • The legend (in the top-right) explains the PK / FK badges and the crow’s-foot cardinality.
  • A theme toggle cycles automatic, light, and dark. Automatic follows your operating system.

Exporting a table

Click a table name in the diagram to open a small menu for that table:

  • Focus this table reduces the diagram to it and its neighbours (the same as picking it in the Focus box). When the table is already focused, this item becomes Unfocus this table, which returns to the full diagram.
  • Copy JSON copies its full structure to the clipboard.
  • Download JSON saves its full structure (columns, keys, indexes) as <table>.json.
  • Download CSV saves a flat, spreadsheet-friendly column list (name, type, nullable, default, and a PK / FK key column) as <table>.csv.

Exports are generated in your browser from the schema Truss already loaded, and contain structure only, never row data, consistent with the rest of Truss.

Multiple connections

If you have configured more than one visualizable connection, a connection switcher appears. Switching re-fetches and re-renders without a full page reload.

Next steps