Network Graph
A dependency-free SVG network graph — clustered nodes at precomputed positions, degree-scaled radii, group-coloured, with hover tooltips.
Preview
A dependency-free SVG network graph. Pass `:nodes` (`id`, `label`, normalised `x`/`y` 0..1, optional `group`) and `:links` (`source`, `target`) to plot your own graph; node radius scales with degree and positions are static (no force simulation).
Controls
Device view renders in an isolated frame so real responsive breakpoints apply. Switch to Full for overflowing popovers.
Installation
php artisan ui:add network-graph
Behavior layer (Alpine)
This component installs a self-registering Alpine module to
resources/js/ui/network-graph.js. Import the behavior layer once
from your bundle so it loads (it hooks alpine:init):
import './network-graph.js';
Registry contract
Install confidence
php artisan ui:add network-graph
writes only the generated targets below. The CLI validates each file hash before writing and
prompts before replacing local changes unless --force is used.
- Version
- 1.0.0
- License
- open
- Stability
- stable
- Contract
- v2
- Foundation
- ≥ 1.0.0
| Type | Generated target |
|---|---|
| blade | resources/views/components/ui/network-graph.blade.php |
| js | resources/js/ui/network-graph.js |
Registry dependencies
None.
Package dependencies
composer: jml/brok:^1.0
npm: alpinejs
Guidance
Diagram and relationship viewExplain hierarchy, causality, network structure, or flow.
Use when
- Use when hierarchy, causality, network structure, or process flow is the information itself. Do not use specialized diagrams when a list, table, or short paragraph would be easier to interpret.
Avoid when
- Avoid using network-graph as a default simply because it is available in the library. Choose it only when its interaction cost, visibility, and behavior match the job to be done.
- Task length
- medium
- Interaction cost
- high
- Interruptiveness
- none
- Input precision
- none
- Mobile / touch risk
- high
- Accessibility risk
- high
- Needs background context
- No
- Comparison needed
- Yes
Preferred alternatives
- List, table, or prose explanation
Anti-patterns
- Using a specialized diagram when linear content is clearer
API
manifest knowledge + registry-derived coverageProps
| Prop | Type / values | Default | Description |
|---|---|---|---|
| nodes | mixed|null | null | Declared by @props in the registry Blade source. |
| links | mixed|null | null | Declared by @props in the registry Blade source. |
| height | int | 360 | Declared by @props in the registry Blade source. |
| label | string | Network graph | Declared by @props in the registry Blade source. |
Slots
Components use the default Blade slot unless a documented subcomponent is installed by the registry item.
Data slots
network-graph
network-graph-edge
network-graph-label
network-graph-node
network-graph-tooltip
Capabilities
Behavior
- Uses server-rendered Blade and semantic HTML.
- Installs a JavaScript behavior module when the registry item includes resources/js/ui files.
- Declares registry capability flags: a11y, interactive, responsive, rtl, darkMode, localized.
Usage
<div class="space-y-4">
<x-ui.network-graph :height="360" label="{{ __('Service dependency graph') }}" />
<p class="text-sm text-muted-foreground">
{{ __('A dependency-free SVG network graph. Pass `:nodes` (`id`, `label`, normalised `x`/`y` 0..1, optional `group`) and `:links` (`source`, `target`) to plot your own graph; node radius scales with degree and positions are static (no force simulation).') }}
</p>
</div>
Accessibility & localization
data-slot
Keyboard focus-visible
Localized labels
- Accessibility target: wcag-2.2-aa-target.
- Uses semantic HTML and a stable
data-slotattribute for styling/scripting hooks. - Focus-visible rings use the
ringtoken so keyboard focus is always visible. - Disabled and invalid states are conveyed to assistive tech, not by color alone.
- Targets WCAG 2.2 AA; verify contrast in light, dark, admin and customer surfaces above.
- Labels go through
__()and the component uses logical properties (ms-*,text-start,start-*) so it mirrors correctly — flip the preview to RTL to confirm.
Source
The exact, editable file ui:add writes
into your app — copy it or own the whole thing. Previews
render this same code; there are no preview-only components.
Changelog
Current version: v1.0.0. See the site changelog for the full release history.