Resource Pages

Open source

Authenticated resource workflows — searchable and selectable index, create, edit, and detail pages with activity history, plus the operator set: an alert-led index, a waiting-for work queue, a stepped record and one create/edit form with save blockers.

2 of 8

resources/views/pages/resource-page-create.blade.php Blade

@props([
    'title'       => 'Create project',
    'description' => 'Add a project and make it available to your team.',
    'indexHref'   => '#',
    'action'      => '#',
    'values'      => null,
    'statusMessage' => null,
    'failureMessage' => null,
    'loadingLabel' => 'Creating…',
    'dirtyGuard' => true,
])

<main
    id="main-content"
    data-slot="resource-create-page"
    data-surface="admin"
    {{ $attributes->merge(['class' => 'min-h-screen bg-background px-4 py-8 text-foreground sm:px-6']) }}
>
    <div class="mx-auto mb-6 max-w-3xl">
        <x-ui.breadcrumb>
            <x-ui.breadcrumb.list>
                <x-ui.breadcrumb.item>
                    <x-ui.breadcrumb.link :href="$indexHref">{{ __('Projects') }}</x-ui.breadcrumb.link>
                </x-ui.breadcrumb.item>
                <x-ui.breadcrumb.separator />
                <x-ui.breadcrumb.item>
                    <x-ui.breadcrumb.page>{{ __('Create') }}</x-ui.breadcrumb.page>
                </x-ui.breadcrumb.item>
            </x-ui.breadcrumb.list>
        </x-ui.breadcrumb>

        <h1 class="mt-4 text-2xl font-semibold tracking-tight sm:text-3xl">{{ __($title) }}</h1>
        <p class="mt-2 max-w-2xl text-sm text-muted-foreground">{{ __($description) }}</p>
    </div>

    <x-blocks.resource-form-create-edit
        mode="create"
        :action="$action"
        :cancel-href="$indexHref"
        :values="$values"
        :status-message="$statusMessage"
        :failure-message="$failureMessage"
        :loading-label="$loadingLabel"
        :dirty-guard="$dirtyGuard"
        title="Project details"
        submit-label="Create project"
    >
        @if (! $slot->isEmpty())
            {{ $slot }}
        @endif
    </x-blocks.resource-form-create-edit>
</main>

Installation

terminal

php artisan ui:add pages/resource-page-create

Installs these dependencies automatically:

breadcrumb blocks/resource-form-create-edit

Registry contract

Install confidence

php artisan ui:add pages/resource-page-create 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.1.2
License: open
Stability: stable
Contract: v2
Foundation: ≥ 1.0.0

Type	Generated target
blade	resources/views/pages/resource-page-create.blade.php

Registry dependencies

breadcrumb blocks/resource-form-create-edit

Package dependencies

composer: jml/brok:^0.2

Use with AI

A brief for your coding agent: what the page is, the install command, how to render it, its props and the rules. Copy it, or open a prompt about this page in an assistant.

resource-page-create.md

# Brok UI page: Create Resource (`resource-page-create`)

A source-bearing create page with breadcrumbs, Laravel validation, submit progress, unsaved-change protection, outcome feedback, and responsive actions.

Brok UI is a Laravel Blade registry. `ui:add` copies this page into the app as plain Blade the app owns; it composes installed `<brok:*>` primitives and semantic design tokens.

## Install

```bash
php artisan ui:add pages/resource-page-create
```

## Render it

```blade
<x-pages.resource-page-create />
```

## Props

- `title` (string, default `Create project`) — Page heading.
- `description` (string, default `Add a project and make it available to your team.`) — Page description.
- `index-href` (string, default `#`) — Back and cancel destination.
- `action` (string, default `#`) — POST action for the new resource.
- `values` (array|null, default `null`) — Optional initial values for the default form fields.
- `status-message` (string|null, default `null`) — Success feedback after a redirect.
- `failure-message` (string|null, default `null`) — Non-validation failure feedback.
- `loading-label` (string, default `Creating…`) — Submit progress label.
- `dirty-guard` (bool, default `true`) — Enables the unsaved-change browser warning.

## Use when

- Use as the create route for a standard authenticated application resource.

## Avoid when

- Use a dialog or inline form for short actions that do not need a dedicated route.

## Rules

- Render the installed page with `<x-pages.resource-page-create />` and pass data through its props; edit the copied file only for structural changes.
- Keep the semantic design tokens (`bg-background`, `text-muted-foreground`); never swap in raw colour utilities.
- Keep the `data-slot` attributes and the logical (start/end) spacing so the markup still mirrors under `dir="rtl"`.

## Links

- Docs: https://brokui.dev/pages/resource-page-create
- Registry JSON (files, props, contract): https://brokui.dev/r/open/pages/resource-page-create.json

Ask about Create Resource in

Working in Claude Code, Cursor or Codex? Give the agent the whole registry through the MCP server or the Brok UI skill.

Guidance

Use when

Use as the create route for a standard authenticated application resource.

Avoid when

Use a dialog or inline form for short actions that do not need a dedicated route.

Anti-patterns

Do not replace semantic props with conflicting utility classes.
Do not remove labels, focus styles, or state attributes.

Anatomy: breadcrumb page heading page description resource form cancel and create actions
Theming hooks: Uses the admin surface and semantic design tokens.

Usage

Render the page as a component, or wire it to a route. Pass data where useful:

resources/views/welcome.blade.php Blade

<x-pages.resource-page-create />

Built from blocks & primitives

This page composes installed <brok:*> primitives and semantic design tokens only — it does not reimplement any primitive. Re-theme it (light, dark, admin, customer) by editing CSS variables; flip the preview to RTL to confirm it mirrors.

Source

The exact, editable file ui:add writes into your app. The preview above renders this same source — there are no preview-only pages.