{
"markdown": "# Aura UI\n\n[](https://packagist.org/packages/bluestarsystem/aura-ui)\n[](https://packagist.org/packages/bluestarsystem/aura-ui)\n[](LICENSE)\n[](https://github.com/BlueStarSystem/aura-ui/actions/workflows/tests.yml)\n[]()\n[]()\n[]()\n\n**\"Vibrant Depth\" UI component library for Laravel 12/13 + Livewire 3/4 + Alpine.js + Tailwind CSS 4.**\n\nAura UI ships **127 production-ready Blade components under the MIT licence** — no account, no\nlicence key, no paid tier required to use them. They share one design system: gradients, glow,\nmicro-animations, glass morphism and full dark mode. Where most libraries go flat and minimal,\nAura deliberately goes the other way, while staying professional.\n\n**[Browse every component →](https://aura-ui.com/components)** · machine-readable index at\n[`/r/registry.json`](https://aura-ui.com/r/registry.json)\n\nDate picker, time picker, file upload, autocomplete, multiselect, calendar, command palette,\nQR code, the editor, a Chart.js-backed chart, and European business fields such as the IBAN\nfield and the currency input — all in the free package.\n\n## Why Aura\n\n- **Breadth, free.** Most libraries put the interesting components behind a licence. Here the\n calendar, the command palette, the date picker and a chart component (line, bar, pie,\n doughnut, area) are MIT.\n- **Own the code.** `php artisan aura:add button` copies the component source into your app.\n Keep Aura as a dependency or walk away with the files — your choice, no lock-in.\n- **Accessibility is tested, not claimed.** 111 colour pairs are checked against the WCAG\n contrast thresholds in CI, and `php artisan aura:doctor --a11y` runs the same checks against\n *your* Blade templates.\n- **Built to be read by AI assistants.** Every docs page is available as raw Markdown by\n appending `.md` to its URL, indexed in [llms.txt](https://aura-ui.com/llms.txt), plus an MCP\n server so your assistant can look up real component APIs instead of inventing them.\n- **1,233 tests** in this package (measured 2026-08-09).\n\n## Requirements\n\n- PHP 8.3+\n- Laravel 12 or 13\n- Tailwind CSS 4\n\nLivewire is optional — the components are anonymous Blade components and work without it.\n\n## Installation\n\n```bash\ncomposer require bluestarsystem/aura-ui\nphp artisan aura:install\n```\n\nImport the CSS in your app:\n\n```css\n/* resources/css/app.css */\n@import \"vendor/aura-ui/aura.css\";\n```\n\nPublish individually if you prefer:\n\n```bash\nphp artisan vendor:publish --tag=aura-ui-config\nphp artisan vendor:publish --tag=aura-ui-css\nphp artisan vendor:publish --tag=aura-ui-views\n```\n\n## Quick Start\n\n```blade\n{{-- Button --}}\nSave Changes\n\n{{-- Input with label and error --}}\nfirst('email') }}\" />\n\n{{-- Card with header --}}\n\n \n Dashboard\n \n Your content here.\n\n\n{{-- Modal --}}\n\n
Are you sure?
\n\n\n{{-- Alert --}}\nOperation completed.\n```\n\n## Components\n\nThe full catalogue, with live previews and props for every component, is at\n**[aura-ui.com/components](https://aura-ui.com/components)**.\n\nIt is deliberately not duplicated here: a list in a README goes stale the moment a component is\nadded, and this one did — it advertised a third of what was actually in the box.\n\nEach page is also available as Markdown for humans and machines alike, e.g.\n[`/docs/components/button.md`](https://aura-ui.com/docs/components/button.md).\n\n## Own the code\n\n```bash\nphp artisan aura:init # prepare the destination and publish the CSS\nphp artisan aura:add button card # copy the source into your project\nphp artisan aura:add table --dry-run # see what it would write first\n```\n\nCopied components are yours: edit them freely, and drop the dependency if you want to.\n\n## Accessibility\n\n```bash\nphp artisan aura:doctor # setup and component-usage problems\nphp artisan aura:doctor --a11y # plus the accessibility checks, on your own views\n```\n\nComponents target WCAG 2.1 AA. Contrast is enforced in CI over 111 colour pairs, in light and\ndark mode, so a theme change cannot quietly push text below the minimum.\n\n## Design System\n\nBuilt on CSS custom properties:\n\n- **Colors**: 6 semantic palettes (primary, secondary, success, warning, danger, info) + surface scale\n- **Shadows**: 6 elevation levels + coloured glow effects for focus states\n- **Animations**: 14 keyframes with spring easing curves\n- **Glass morphism**: 3 intensity levels (subtle, standard, strong)\n- **Typography**: Inter (sans) + JetBrains Mono (mono)\n- **Border radius**: 6-step scale from 6px to 9999px\n\n### Dark Mode\n\nAdd `.dark` to ``; colours, shadows and glows adapt on their own.\n\n```html\n\n```\n\n### Theming\n\n```css\n:root {\n --aura-primary-500: #8b5cf6; /* Change primary to violet */\n --aura-radius-md: 12px; /* Rounder corners */\n}\n```\n\nFull guide: [Theming](https://aura-ui.com/docs/theming) · [Dark Mode](https://aura-ui.com/docs/dark-mode).\n\n### Translations\n\nShips with English and Italian strings; publish `aura-ui-lang` to add your own.\n\n## Playground\n\nVisit `/aura/playground` in your app to browse every component live:\n\n```php\n// config/aura-ui.php\n'playground' => [\n 'enabled' => env('AURA_PLAYGROUND', true),\n],\n```\n\n## Testing\n\n```bash\ncomposer install\nvendor/bin/pest\n```\n\n## Links\n\n- [Documentation](https://aura-ui.com) — full docs, live previews, playground\n- [All components](https://aura-ui.com/components) · [llms.txt](https://aura-ui.com/llms.txt) for AI assistants\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\n## Credits\n\n- [Juri Montico](https://bluestarsystem.it) — BlueStarSystem\n",
"bytes": 6579,
"sha": "ec2f098bd5a44aded19097490464cec6a55b9f1dfea3e40df7ec741ee667647b",
"repo_slug": "bluestarsystem/aura-ui",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_bluestarsystem_aura_ui_86207f4c/readme"
}