cornell-custom-dev/cd-laravel-base

Cornell Custom Dev Laravel starter kit for Livewire.

dev-main 2025-11-25 14:48 UTC

Requires

• php: ^8.2
• cornell-custom-dev/cds: ^1.2.0@beta
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• livewire/flux-pro: ^2.6
• livewire/volt: ^1.7.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.24
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^11.5.3

MIT

• framework
• laravel

README

Setup

Run composer setup after cloning to set up your environment.

FluxPro components will not be accessible until you provide Flux repo credentials in auth.json.

Note: If you run composer setup inside the lando container you will need to provide a GitHub Token to access the private https://github.com/CornellCustomDev/cds repository.

Layout

The Layout is built with the Cornell Design System: https://cornellcustomdev.github.io/cds-docs/

Edit the layout starting at resources/views/components/cds/layout/app.blade.php

Components

Components are built with FluxPro. Examples of components are at resources/views/examples/form.blade.php

Available components:

• Text input

Using components

Components are used in blade files with the <x-cds syntax. For example, to use the text input forms component, you would write:

<x-cds.forms.input
    name="email"
    label="Email"
/>

You can also pass additional attributes to the component and they will be applied to the contained input element ("required" in this case). Named slots can also be used to fill attributes. For example:

<x-cds.forms.input name="name" label="Name" required>
    <x-slot:description>
        Please enter your full name.
    </x-slot:description>
</x-cds.forms.input>

Common and defaulted attributes can be found in the component's blade file, generally as @prop definitions so that an IDE can provide autocomplete.

The underlying Flux component documentation is linked from the blade file and should be consulted for additional options and usage.