mirror of
https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
synced 2026-04-25 11:18:17 +00:00
feat: resolve 8 enhancement issues — Angular, Laravel, KiloCode, global install, uninstall, Warp, Augment, add-skill
- Add Angular stack guidelines (50 rows) with signals, standalone components, defer blocks (#203) - Add Laravel stack guidelines (50 rows) with Blade, Livewire, Inertia.js (#105) - Add KiloCode platform support (.kilocode/skills/) as Roo Code fork (#89) - Add global install mode: `uipro init --global` installs to ~/ (#75) - Add uninstall command: `uipro uninstall` with auto-detect (#185) - Add Warp platform support (#88) - Add Augment platform support (#41) - Add skill.json manifest for add-skill registry (#95) - Update README with new platforms, stacks, CLI commands
This commit is contained in:
parent
f4ad784539
commit
2910a74e57
21
README.md
Normal file → Executable file
21
README.md
Normal file → Executable file
@ -154,7 +154,7 @@ Each rule includes:
|
|||||||
- **161 Color Palettes** - Industry-specific palettes aligned 1:1 with the 161 product types
|
- **161 Color Palettes** - Industry-specific palettes aligned 1:1 with the 161 product types
|
||||||
- **57 Font Pairings** - Curated typography combinations with Google Fonts imports
|
- **57 Font Pairings** - Curated typography combinations with Google Fonts imports
|
||||||
- **25 Chart Types** - Recommendations for dashboards and analytics
|
- **25 Chart Types** - Recommendations for dashboards and analytics
|
||||||
- **13 Tech Stacks** - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose
|
- **15 Tech Stacks** - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel
|
||||||
- **99 UX Guidelines** - Best practices, anti-patterns, and accessibility rules
|
- **99 UX Guidelines** - Best practices, anti-patterns, and accessibility rules
|
||||||
- **161 Reasoning Rules** - Industry-specific design system generation (NEW in v2.0)
|
- **161 Reasoning Rules** - Industry-specific design system generation (NEW in v2.0)
|
||||||
|
|
||||||
@ -287,15 +287,28 @@ uipro init --ai opencode # OpenCode
|
|||||||
uipro init --ai continue # Continue
|
uipro init --ai continue # Continue
|
||||||
uipro init --ai codebuddy # CodeBuddy
|
uipro init --ai codebuddy # CodeBuddy
|
||||||
uipro init --ai droid # Droid (Factory)
|
uipro init --ai droid # Droid (Factory)
|
||||||
|
uipro init --ai kilocode # KiloCode
|
||||||
|
uipro init --ai warp # Warp
|
||||||
|
uipro init --ai augment # Augment
|
||||||
uipro init --ai all # All assistants
|
uipro init --ai all # All assistants
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Global Install (Available for All Projects)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
uipro init --ai claude --global # Install to ~/.claude/skills/
|
||||||
|
uipro init --ai cursor --global # Install to ~/.cursor/skills/
|
||||||
|
```
|
||||||
|
|
||||||
### Other CLI Commands
|
### Other CLI Commands
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
uipro versions # List available versions
|
uipro versions # List available versions
|
||||||
uipro update # Update to latest version
|
uipro update # Update to latest version
|
||||||
uipro init --offline # Skip GitHub download, use bundled assets
|
uipro init --offline # Skip GitHub download, use bundled assets
|
||||||
|
uipro uninstall # Remove skill (auto-detect platform)
|
||||||
|
uipro uninstall --ai claude # Remove specific platform
|
||||||
|
uipro uninstall --global # Remove from global install
|
||||||
```
|
```
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
@ -320,7 +333,7 @@ winget install Python.Python.3.12
|
|||||||
|
|
||||||
### Skill Mode (Auto-activate)
|
### Skill Mode (Auto-activate)
|
||||||
|
|
||||||
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory)
|
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment
|
||||||
|
|
||||||
The skill activates automatically when you request UI/UX work. Just chat naturally:
|
The skill activates automatically when you request UI/UX work. Just chat naturally:
|
||||||
|
|
||||||
@ -332,7 +345,7 @@ Build a landing page for my SaaS product
|
|||||||
|
|
||||||
### Workflow Mode (Slash Command)
|
### Workflow Mode (Slash Command)
|
||||||
|
|
||||||
**Supported:** Kiro, GitHub Copilot, Roo Code
|
**Supported:** Kiro, GitHub Copilot, Roo Code, KiloCode
|
||||||
|
|
||||||
Use the slash command to invoke the skill:
|
Use the slash command to invoke the skill:
|
||||||
|
|
||||||
@ -371,6 +384,8 @@ The skill provides stack-specific guidelines for:
|
|||||||
| **Web (HTML)** | HTML + Tailwind (default) |
|
| **Web (HTML)** | HTML + Tailwind (default) |
|
||||||
| **React Ecosystem** | React, Next.js, shadcn/ui |
|
| **React Ecosystem** | React, Next.js, shadcn/ui |
|
||||||
| **Vue Ecosystem** | Vue, Nuxt.js, Nuxt UI |
|
| **Vue Ecosystem** | Vue, Nuxt.js, Nuxt UI |
|
||||||
|
| **Angular** | Angular |
|
||||||
|
| **PHP** | Laravel (Blade, Livewire, Inertia.js) |
|
||||||
| **Other Web** | Svelte, Astro |
|
| **Other Web** | Svelte, Astro |
|
||||||
| **iOS** | SwiftUI |
|
| **iOS** | SwiftUI |
|
||||||
| **Android** | Jetpack Compose |
|
| **Android** | Jetpack Compose |
|
||||||
|
|||||||
51
cli/assets/data/stacks/angular.csv
Normal file
51
cli/assets/data/stacks/angular.csv
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
|
||||||
|
1,Components,Use standalone components,Angular 17+ default; no NgModule needed,Standalone components for all new code,NgModule-based components for new projects,"@Component({ standalone: true imports: [CommonModule] })","@NgModule({ declarations: [MyComp] })",High,https://angular.dev/guide/components/importing
|
||||||
|
2,Components,Use signals for state,Signals are Angular's reactive primitive for fine-grained reactivity,Signals for component state over class properties,Mutable class properties without signals,"count = signal(0); increment() { this.count.update(v => v + 1) }","count = 0; increment() { this.count++ }",High,https://angular.dev/guide/signals
|
||||||
|
3,Components,Use @if/@for/@switch control flow,Built-in control flow syntax replaces *ngIf/*ngFor directives,@if and @for in templates,*ngIf and *ngFor structural directives,"@if (isLoggedIn) { <Dashboard /> } @else { <Login /> }","<div *ngIf=""isLoggedIn""><Dashboard /></div>",High,https://angular.dev/guide/templates/control-flow
|
||||||
|
4,Components,Use input() and output() signals,Signal-based inputs/outputs replace @Input()/@Output() decorators,input() and output() for component API,@Input() and @Output() decorators,"name = input<string>(); clicked = output<void>()","@Input() name: string; @Output() clicked = new EventEmitter()",High,https://angular.dev/guide/components/inputs
|
||||||
|
5,Components,Use content projection,ng-content for flexible component composition,ng-content with select for named slots,Rigid templates that can't be customized,"<ng-content select=""[header]"" /> <ng-content />","<div class=""header"">{{ title }}</div>",Medium,https://angular.dev/guide/components/content-projection
|
||||||
|
6,Components,Keep components small,Single responsibility; components should do one thing,Extract sub-components when template exceeds 50 lines,Monolithic components handling multiple concerns,"<UserAvatar /> <UserDetails /> <UserActions />",One 300-line component template,Medium,https://angular.dev/guide/components
|
||||||
|
7,Components,Use OnPush change detection,Reduces re-renders by only checking on input changes or signal updates,OnPush for all components,Default change detection strategy,"changeDetection: ChangeDetectionStrategy.OnPush","changeDetection: ChangeDetectionStrategy.Default",High,https://angular.dev/guide/components/lifecycle
|
||||||
|
8,Components,Avoid direct DOM manipulation,Use renderer or ElementRef sparingly; prefer template bindings,Template bindings and Angular directives,Direct document.querySelector or innerHTML,"[class.active]=""isActive""","this.el.nativeElement.classList.add('active')",High,https://angular.dev/guide/components/host-elements
|
||||||
|
9,Routing,Lazy load feature routes,Load route chunks on demand to reduce initial bundle,loadComponent() for all feature routes,Eager-loaded routes in app config,"{ path: 'admin' loadComponent: () => import('./admin/admin.component') }","{ path: 'admin' component: AdminComponent }",High,https://angular.dev/guide/routing/lazy-loading
|
||||||
|
10,Routing,Use route guards with functional API,Protect routes with canActivate/canMatch functional guards,Functional guards returning boolean or UrlTree,Class-based guards with CanActivate interface,"canActivate: [() => inject(AuthService).isLoggedIn()]","canActivate: [AuthGuard]",High,https://angular.dev/guide/routing/common-router-tasks#preventing-unauthorized-access
|
||||||
|
11,Routing,Use route resolvers for data,Pre-fetch data before route activation using resolve,ResolveFn for route data,Fetching data in ngOnInit causing flash of empty state,"resolve: { user: () => inject(UserService).getUser() }",Fetch in ngOnInit with loading state flickering,Medium,https://angular.dev/guide/routing/common-router-tasks#resolve
|
||||||
|
12,Routing,Type route params with inject,Use inject(ActivatedRoute) with signals or toSignal,Typed route params via ActivatedRoute,Untyped route.snapshot.params string access,"const id = toSignal(route.paramMap.pipe(map(p => p.get('id'))))","const id = this.route.snapshot.params['id']",Medium,https://angular.dev/api/router/ActivatedRoute
|
||||||
|
13,Routing,Use nested routes for layouts,Compose shared layouts using router-outlet nesting,Nested routes with shared layout components,Duplicating layout code across routes,"{ path: 'app' component: ShellComponent children: [...] }",Duplicate header/sidebar in each route component,Medium,https://angular.dev/guide/routing/router-tutorial-toh#child-route-configuration
|
||||||
|
14,Routing,Configure preloading strategies,Preload lazy modules in background after initial load,PreloadAllModules or custom strategy,No preloading causing delayed navigation,"provideRouter(routes withPreloading(PreloadAllModules))","provideRouter(routes)",Low,https://angular.dev/api/router/PreloadAllModules
|
||||||
|
15,State,Use signals for local state,Signals provide synchronous reactive state without RxJS overhead,signal() for component-local reactive state,BehaviorSubject for simple local state,"const items = signal<Item[]>([]); addItem(i: Item) { this.items.update(arr => [...arr i]) }","items$ = new BehaviorSubject<Item[]>([])",High,https://angular.dev/guide/signals
|
||||||
|
16,State,Use computed() for derived state,Lazily evaluated derived values that update when dependencies change,computed() for values derived from other signals,Duplicated state or manual sync,"readonly total = computed(() => this.items().reduce((s i) => s + i.price 0))","this.total = this.items.reduce(...) // called manually",High,https://angular.dev/guide/signals#computed-signals
|
||||||
|
17,State,Use effect() carefully,Effects run side effects when signals change; avoid overuse,effect() for side effects like logging or localStorage sync,effect() for deriving state (use computed instead),"effect(() => localStorage.setItem('cart' JSON.stringify(this.cart())))","effect(() => { this.total.set(this.items().length) })",Medium,https://angular.dev/guide/signals#effects
|
||||||
|
18,State,Use NgRx Signal Store for complex state,NgRx Signal Store is the modern lightweight state management for Angular,@ngrx/signals SignalStore for feature state,Full NgRx reducer/action/effect boilerplate for simple state,"const Store = signalStore(withState({ count: 0 }) withMethods(s => ({ increment: () => patchState(s { count: s.count() + 1 }) })))","createReducer(on(increment state => ({ ...state count: state.count + 1 })))",Medium,https://ngrx.io/guide/signals
|
||||||
|
19,State,Inject services for shared state,Services with signals share state across components without a store,Injectable service with signals for cross-component state,Prop drilling or @Input chains for shared state,"@Injectable({ providedIn: 'root' }) class CartService { items = signal<Item[]>([]) }","@Input() cartItems passed through 4 component levels",Medium,https://angular.dev/guide/di/creating-injectable-service
|
||||||
|
20,State,Avoid mixing RxJS and signals unnecessarily,Use toSignal() to bridge RxJS into signal world at the boundary,toSignal() to convert observable to signal at component edge,Subscribing in components and storing in signal manually,"readonly user = toSignal(this.userService.user$)","this.userService.user$.subscribe(u => this.user.set(u))",Medium,https://angular.dev/guide/rxjs-interop
|
||||||
|
21,Forms,Use typed reactive forms,FormGroup/FormControl with explicit generics for compile-time safety,FormBuilder with typed controls,Untyped FormControl or any casts,"fb.group<LoginForm>({ email: fb.control('') password: fb.control('') })","new FormGroup({ email: new FormControl(null) })",High,https://angular.dev/guide/forms/typed-forms
|
||||||
|
22,Forms,Use reactive forms over template-driven,Reactive forms scale better and are fully testable,ReactiveFormsModule for all non-trivial forms,FormsModule with ngModel for complex forms,"<input [formControl]=""emailControl"" />","<input [(ngModel)]=""email"" />",Medium,https://angular.dev/guide/forms/reactive-forms
|
||||||
|
23,Forms,Write custom validators as functions,Functional validators are composable and tree-shakeable,ValidatorFn functions for custom validation,Class-based validators implementing Validator interface,"const noSpaces: ValidatorFn = ctrl => ctrl.value?.includes(' ') ? { noSpaces: true } : null","class NoSpacesValidator implements Validator { validate(c) {} }",Medium,https://angular.dev/guide/forms/form-validation#custom-validators
|
||||||
|
24,Forms,Use updateOn for performance,Control when validation runs to avoid per-keystroke validation overhead,updateOn: 'blur' or 'submit' for expensive validators,Default updateOn: 'change' for async validators,"fb.control('' { updateOn: 'blur' validators: [Validators.email] })","fb.control('' [Validators.email]) // validates on every key",Low,https://angular.dev/api/forms/AbstractControl#updateOn
|
||||||
|
25,Forms,Use FormArray for dynamic fields,FormArray manages variable-length lists of controls,FormArray for add/remove field scenarios,Manually tracking index-based controls,"get items(): FormArray { return this.form.get('items') as FormArray }","items: [FormControl] managed outside form",Medium,https://angular.dev/guide/forms/reactive-forms#using-the-formarray-class
|
||||||
|
26,Forms,Display validation errors clearly,Use form control touched and dirty states to show errors at the right time,Show errors after field is touched,Show all errors on page load,"@if (email.invalid && email.touched) { <span>Invalid email</span> }","@if (email.invalid) { <span>Invalid email</span> }",Medium,https://angular.dev/guide/forms/form-validation
|
||||||
|
27,Performance,Apply OnPush to all components,OnPush + signals eliminates most unnecessary change detection cycles,OnPush change detection everywhere,Default strategy which checks entire tree on every event,changeDetection: ChangeDetectionStrategy.OnPush,changeDetection: ChangeDetectionStrategy.Default,High,https://angular.dev/best-practices/skipping-component-subtrees
|
||||||
|
28,Performance,Use trackBy in @for blocks,Stable identity for list items prevents full DOM re-creation on change,track item.id in @for,"@for (item of items; track item.id) { <li>{{ item.name }}</li> }","@for (item of items; track $index) { <li>{{ item.name }}</li> }",High,https://angular.dev/guide/templates/control-flow#track-and-identity
|
||||||
|
29,Performance,Use @defer for below-the-fold content,Defer blocks lazy-load components when they enter the viewport,@defer with on viewport for non-critical UI,Eagerly loading all components at startup,"@defer (on viewport) { <HeavyChart /> } @placeholder { <Skeleton /> }","<HeavyChart /> loaded at startup",High,https://angular.dev/guide/defer
|
||||||
|
30,Performance,Use NgOptimizedImage,Enforces image best practices: lazy loading LCP hints and proper sizing,NgOptimizedImage for all img tags,Plain img tags for CMS or user content,"<img ngSrc=""/hero.jpg"" width=""800"" height=""400"" priority />","<img src=""/hero.jpg"" />",High,https://angular.dev/guide/image-optimization
|
||||||
|
31,Performance,Tree-shake unused Angular features,Import only what you use from Angular packages,Import specific Angular modules needed,Import BrowserAnimationsModule when not using animations,"import { NgOptimizedImage } from '@angular/common'","import { CommonModule } from '@angular/common' // entire module",Medium,https://angular.dev/tools/cli/build
|
||||||
|
32,Performance,Avoid subscribe in components,Subscriptions leak and cause bugs; prefer async pipe or toSignal,toSignal() or async pipe instead of manual subscribe,Manual subscribe without unsubscribe in ngOnDestroy,"readonly data = toSignal(this.service.data$)","this.service.data$.subscribe(d => this.data = d)",High,https://angular.dev/guide/rxjs-interop
|
||||||
|
33,Performance,Use SSR with Angular Universal,Pre-render pages for faster LCP and better SEO,SSR or SSG for public-facing routes,Pure CSR for SEO-critical pages,"ng add @angular/ssr","// no SSR, client renders empty shell",Medium,https://angular.dev/guide/ssr
|
||||||
|
34,Performance,Minimize bundle with standalone APIs,Standalone components + provideRouter() eliminate dead NgModule code,provideRouter() and provideHttpClient() in app.config,Root AppModule with all imports,provideRouter(routes) in app.config.ts,"@NgModule({ imports: [RouterModule.forRoot(routes)] })",Medium,https://angular.dev/guide/routing/standalone
|
||||||
|
35,Testing,Use TestBed for component tests,TestBed sets up Angular DI for realistic component testing,TestBed.configureTestingModule for component tests,Instantiate components with new keyword,"TestBed.configureTestingModule({ imports: [MyComponent] })","const comp = new MyComponent()",High,https://angular.dev/guide/testing/components-basics
|
||||||
|
36,Testing,Use Angular CDK component harnesses,Harnesses provide a stable testing API that survives template refactors,MatButtonHarness and custom HarnessLoader,Direct native element queries that break on template changes,"const btn = await loader.getHarness(MatButtonHarness)","fixture.debugElement.query(By.css('button'))",Medium,https://material.angular.io/cdk/test-harnesses/overview
|
||||||
|
37,Testing,Use Spectator for less boilerplate,Spectator wraps TestBed with a cleaner API reducing test setup noise,Spectator for unit tests,Raw TestBed for every test,"const spectator = createComponentFactory(MyComponent)","TestBed.configureTestingModule({ declarations: [MyComponent] providers: [...] })",Low,https://github.com/ngneat/spectator
|
||||||
|
38,Testing,Mock services with jasmine.createSpyObj,Isolate unit tests by providing mock implementations of dependencies,SpyObj or jest.fn() mocks for services,Real HTTP calls in unit tests,"const spy = jasmine.createSpyObj('UserService' ['getUser']); spy.getUser.and.returnValue(of(user))","providers: [UserService] // real service in unit test",High,https://angular.dev/guide/testing/services
|
||||||
|
39,Testing,Write integration tests for routes,Test full route navigation including guards and resolvers,RouterTestingHarness for route integration tests,Mock all routing behavior in unit tests,"const harness = await RouterTestingHarness.create(); await harness.navigateByUrl('/home')","// manually calling route guard methods",Medium,https://angular.dev/api/router/testing/RouterTestingHarness
|
||||||
|
40,Testing,Test signal-based components,Signals update synchronously; no async flush needed in most cases,Read signal value directly in test assertions,TestBed.tick() or fakeAsync for signal reads,"component.count.set(5); expect(component.double()).toBe(10)","fakeAsync(() => { component.count.set(5); tick(); expect(component.double()).toBe(10) })",Medium,https://angular.dev/guide/testing
|
||||||
|
41,Styling,Use ViewEncapsulation.Emulated,Default emulation scopes styles to component preventing global leaks,Emulated or None for intentional global styles,ViewEncapsulation.None for component-specific styles,ViewEncapsulation.Emulated (default),ViewEncapsulation.None on feature components,Medium,https://angular.dev/guide/components/styling#style-scoping
|
||||||
|
42,Styling,Use :host selector,Style the component's host element using :host pseudo-class,":host for host element styles",Adding wrapper div just for styling,":host { display: block; padding: 1rem }","<div class=""wrapper"">...</div> + .wrapper { padding: 1rem }",Medium,https://angular.dev/guide/components/styling#host-element
|
||||||
|
43,Styling,Use CSS custom properties for theming,CSS variables work across component boundaries and enable dynamic theming,CSS custom properties for colors and spacing,Hardcoded hex values in component styles,":root { --primary: #6200ee } button { background: var(--primary) }","button { background: #6200ee }",Medium,https://angular.dev/guide/components/styling
|
||||||
|
44,Styling,Integrate Tailwind with Angular,Tailwind utilities work alongside Angular's ViewEncapsulation via global stylesheet,Add Tailwind in styles.css and use utility classes in templates,Custom CSS for layout that Tailwind already handles,"<div class=""flex items-center gap-4 p-6"">","<div class=""my-custom-flex""> /* .my-custom-flex { display: flex } */",Low,https://tailwindcss.com/docs/guides/angular
|
||||||
|
45,Styling,Use Angular Material theming tokens,Material 3 uses design tokens for systematic theming,M3 token-based theming for Angular Material,Overriding Angular Material CSS with deep selectors,"@include mat.button-theme($my-theme)","::ng-deep .mat-button { background: red }",Medium,https://material.angular.io/guide/theming
|
||||||
|
46,Architecture,Use injection tokens for config,Provide configuration via InjectionToken for testability and flexibility,InjectionToken for environment-specific values,Importing environment.ts directly in services,"const API_URL = new InjectionToken<string>('apiUrl'); provide: [{ provide: API_URL useValue: env.apiUrl }]","constructor(private env: Environment) { this.url = env.apiUrl }",Medium,https://angular.dev/guide/di/dependency-injection-providers#using-an-injectiontoken-object
|
||||||
|
47,Architecture,Use HTTP interceptors,Intercept requests for auth headers error handling and logging,Functional interceptors with withInterceptors(),Service-level header management in every request,"withInterceptors([authInterceptor errorInterceptor])","httpClient.get(url { headers: { Authorization: token } }) in every call",High,https://angular.dev/guide/http/interceptors
|
||||||
|
48,Architecture,Organize by feature not type,Feature-based folder structure scales better than type-based,Feature folders with collocated component service and routes,Flat folders: all-components/ all-services/,"src/features/checkout/checkout.component.ts checkout.service.ts checkout.routes.ts","src/components/checkout.component.ts src/services/checkout.service.ts",Medium,https://angular.dev/style-guide#folders-by-feature-structure
|
||||||
|
49,Architecture,Use environment configurations,Separate environment values for dev staging and prod via Angular build configs,angular.json fileReplacements for env configs,Hardcoded API URLs or feature flags in source,"fileReplacements: [{ replace: environment.ts with: environment.prod.ts }]","const API = 'https://api.example.com' // hardcoded in service",High,https://angular.dev/tools/cli/environments
|
||||||
|
50,Architecture,Prefer inject() over constructor DI,inject() function is composable and works in more contexts than constructor injection,inject() for dependency injection,Constructor parameters for new code,"readonly http = inject(HttpClient); readonly router = inject(Router)","constructor(private http: HttpClient private router: Router) {}",Medium,https://angular.dev/api/core/inject
|
||||||
|
Can't render this file because it has a wrong number of fields in line 29.
|
51
cli/assets/data/stacks/laravel.csv
Normal file
51
cli/assets/data/stacks/laravel.csv
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
|
||||||
|
1,Blade Templates,Use Blade components for reusable UI,Extract repeated markup into named Blade components,Use x-* components with @props for all reusable UI,Duplicate HTML blocks across views,<x-card :title="$title">{{ $slot }}</x-card>,@include('card' ['title' => $title]),High,https://laravel.com/docs/blade#components
|
||||||
|
2,Blade Templates,Use layouts with @extends and @section,Define one master layout and extend it per page,@extends layout with named @section blocks,Duplicate header/footer HTML in every view,@extends('layouts.app') @section('content'),Full HTML in every view file,High,https://laravel.com/docs/blade#layouts-using-template-inheritance
|
||||||
|
3,Blade Templates,Use @props for component type-safety,Declare accepted props inside components with @props,@props with defaults to document component API,Pass arbitrary variables without declaration,@props(['title' => '' 'variant' => 'primary']),No @props declaration in component,Medium,https://laravel.com/docs/blade#component-data-and-attributes
|
||||||
|
4,Blade Templates,Use conditional CSS classes with @class,Build class strings conditionally without ternary noise,@class directive for conditional class binding,String concatenation or nested ternaries,@class(['btn' 'btn-primary' => $primary 'btn-disabled' => $disabled]),class="btn {{ $primary ? 'btn-primary' : '' }}",Medium,https://laravel.com/docs/blade#conditional-classes-and-styles
|
||||||
|
5,Blade Templates,Use named slots for flexible layouts,Named slots let callers inject content into specific regions,@slot('header') and $slot for flexible component APIs,Hard-code all sub-sections inside components,"<x-modal><x-slot:header>Title</x-slot>Body</x-modal>",<x-modal title="Title">Body with no slot control</x-modal>,Medium,https://laravel.com/docs/blade#slots
|
||||||
|
6,Blade Templates,Use Blade directives instead of raw PHP,Blade directives are readable and IDE-supported,@if @foreach @forelse @empty instead of <?php ?>,Raw PHP tags inside Blade templates,@forelse($items as $item) ... @empty <p>None</p> @endforelse,<?php foreach($items as $item): ?>,High,https://laravel.com/docs/blade#blade-directives
|
||||||
|
7,Blade Templates,Escape output with {{ }},Use double curly braces for XSS-safe output,{{ }} for all user-supplied or dynamic text,{!! !!} for untrusted data,{{ $user->name }},{!! $user->name !!},High,https://laravel.com/docs/blade#displaying-data
|
||||||
|
8,Blade Templates,Use @vite for asset loading,Vite integration handles cache busting and HMR automatically,@vite(['resources/css/app.css' 'resources/js/app.js']),Manual script/link tags with hardcoded paths,@vite(['resources/css/app.css' 'resources/js/app.js']),<link href="/css/app.css?v=123">,High,https://laravel.com/docs/vite
|
||||||
|
9,Livewire,Bind inputs with wire:model,Two-way data binding keeps component state in sync,wire:model for all form inputs managed by Livewire,Manual JavaScript listeners syncing to component,<input wire:model="email">,<input @change="$wire.email = $event.target.value">,High,https://livewire.laravel.com/docs/properties
|
||||||
|
10,Livewire,Use wire:model.live for real-time validation,Validate on input rather than only on submit,wire:model.live + #[Validate] for instant feedback,Only validate on form submit,<input wire:model.live="email"> with #[Validate('email')],<input wire:model="email"> with validate() on submit only,Medium,https://livewire.laravel.com/docs/validation
|
||||||
|
11,Livewire,Use wire:click for actions,Bind UI events to component methods cleanly,wire:click for buttons and interactive elements,JavaScript fetch calls replicating Livewire actions,<button wire:click="save">Save</button>,<button onclick="fetch('/save')">Save</button>,High,https://livewire.laravel.com/docs/actions
|
||||||
|
12,Livewire,Use lifecycle hooks appropriately,mount() for init; updated() for reactive side effects,mount() for initialization updatedFoo() for property changes,Heavy logic in render() or __construct(),public function mount(): void { $this->items = Item::all(); },public function render(): View { $this->items = Item::all(); },Medium,https://livewire.laravel.com/docs/lifecycle-hooks
|
||||||
|
13,Livewire,Use lazy loading for heavy components,Defer render of expensive components until visible,wire:init or lazy attribute on components,Load all Livewire components on page load,<livewire:analytics-chart lazy />,<livewire:analytics-chart /> with heavy DB queries on mount,Medium,https://livewire.laravel.com/docs/lazy
|
||||||
|
14,Livewire,Integrate Alpine.js for local UI state,Use Alpine.js for UI-only state that doesn't need server round-trips,x-data / x-show / x-transition for tooltips dropdowns,Livewire server calls for purely visual toggle state,<div x-data="{ open: false }"><button @click="open = !open">,<button wire:click="toggleDropdown"> for a local dropdown,Medium,https://livewire.laravel.com/docs/alpine
|
||||||
|
15,Livewire,Use wire:loading for feedback,Always indicate to users when a server action is in progress,wire:loading.attr="disabled" and wire:loading elements,Provide no feedback while Livewire request is in flight,<button wire:click="save" wire:loading.attr="disabled">Save</button>,<button wire:click="save">Save</button> with no loading state,High,https://livewire.laravel.com/docs/wire-loading
|
||||||
|
16,Livewire,Handle file uploads with WithFileUploads,Livewire's trait manages chunked upload and temp storage,WithFileUploads trait + wire:model for file inputs,Manual multipart form submissions for Livewire pages,use WithFileUploads; public $photo; <input wire:model="photo" type="file">,<form action="/upload" method="POST" enctype="multipart/form-data">,Medium,https://livewire.laravel.com/docs/uploads
|
||||||
|
17,Inertia.js,Use Inertia page components as route endpoints,Each page is a Vue/React component rendered server-side via Inertia::render(),Inertia::render('Dashboard' ['data' => $data]) in controllers,Return JSON and fetch from JavaScript,return Inertia::render('Users/Index' ['users' => $users]);,return response()->json($users); with client-side fetch,High,https://inertiajs.com/responses
|
||||||
|
18,Inertia.js,Share global data via HandleInertiaRequests,Middleware share() provides auth user and flash to every page,Share auth/flash in HandleInertiaRequests middleware,Pass auth to every Inertia::render() call,public function share(Request $r): array { return ['auth' => ['user' => $r->user()]]; },Inertia::render('Page' ['auth' => auth()->user()]) every controller,High,https://inertiajs.com/shared-data
|
||||||
|
19,Inertia.js,Use <Link> for client-side navigation,Inertia Link intercepts clicks for SPA-like transitions,<Link href="/dashboard"> instead of <a href>,Regular <a> tags for internal navigation,<Link href={route('dashboard')}>Dashboard</Link>,<a href="/dashboard">Dashboard</a>,High,https://inertiajs.com/links
|
||||||
|
20,Inertia.js,Use useForm for form state and submission,Inertia's useForm manages progress errors and transforms,"useForm for all page-level forms, form.post() for submit",Axios/fetch for form submissions on Inertia pages,"const form = useForm({ name: '' }); form.post('/users');","axios.post('/users', { name });",High,https://inertiajs.com/forms
|
||||||
|
21,Inertia.js,Use persistent layouts to preserve state,Wrap pages in a persistent layout so header/sidebar don't remount,layout property on page component for persistent UI,Re-render full layout on every page visit,MyPage.layout = (page) => <AppLayout>{page}</AppLayout>,No layout — full page reload feel on navigation,Medium,https://inertiajs.com/pages#persistent-layouts
|
||||||
|
22,Inertia.js,Enable SSR for public pages,Server-side rendering improves SEO and first paint,Enable Inertia SSR for marketing and public pages,Client-only rendering for all pages including public,php artisan inertia:start-ssr with @inertiaHead,No SSR on pages requiring good SEO,Medium,https://inertiajs.com/server-side-rendering
|
||||||
|
23,Styling,Set up Tailwind CSS via Vite,Use Vite + tailwindcss plugin for fast HMR and optimized builds,Install tailwindcss @tailwindcss/vite and configure vite.config.js,Laravel Mix or manual PostCSS pipeline for new projects,plugins: [tailwindcss()] in vite.config.js + @import 'tailwindcss' in app.css,Laravel Mix with require('tailwindcss') in webpack,High,https://tailwindcss.com/docs/installation/framework-guides
|
||||||
|
24,Styling,Purge unused styles via content config,Tailwind scans Blade and JS files to tree-shake unused classes,content: ['./resources/views/**/*.blade.php' './resources/js/**/*.{js,vue}'],No content config — ship all 3MB of CSS,content: ['./resources/**/*.blade.php' './resources/**/*.js'],content: [],High,https://tailwindcss.com/docs/content-configuration
|
||||||
|
25,Styling,Use dark mode class strategy,class-based dark mode integrates with server-rendered preference,darkMode: 'class' with a toggle that sets class on <html>,Media query only — no user override possible,darkMode: 'class'; document.documentElement.classList.toggle('dark'),darkMode: 'media' — no programmatic control,Medium,https://tailwindcss.com/docs/dark-mode
|
||||||
|
26,Styling,Use @apply sparingly in component CSS,Extract only truly repeated multi-class patterns,@apply for BEM base classes shared across many components,@apply for every single element — defeats Tailwind's purpose,@apply flex items-center gap-2 (shared button base),@apply text-sm for a single use,Low,https://tailwindcss.com/docs/functions-and-directives#apply
|
||||||
|
27,Styling,Configure custom design tokens in CSS,Define brand colors spacing fonts as CSS variables consumed by Tailwind,Custom @theme tokens matched to brand guidelines,Magic color hex codes scattered across Blade templates,@theme { --color-brand: oklch(0.6 0.2 250); },bg-[#1a2b3c] inline throughout templates,Medium,https://tailwindcss.com/docs/theme
|
||||||
|
28,Components,Use anonymous Blade components for UI primitives,Blade files in resources/views/components/ auto-register as x-* components,Anonymous components for buttons alerts badges cards,Blade @includes for anything reusable,<x-badge variant="success">Active</x-badge>,@include('partials.badge' ['variant' => 'success']),Medium,https://laravel.com/docs/blade#anonymous-components
|
||||||
|
29,Components,Use class-based components for complex logic,PHP class components can inject services and pre-process data,app/View/Components/ class when component needs PHP logic,Blade @php blocks for business logic inside templates,class AlertComponent { public function __construct(public string $type) {} },@php $color = $type === 'error' ? 'red' : 'green'; @endphp,Medium,https://laravel.com/docs/blade#components
|
||||||
|
30,Components,Forward extra attributes with $attributes,Pass through HTML attributes like class id aria to root element,$attributes->merge() on root element of components,Ignore caller-provided HTML attributes silently,<div {{ $attributes->merge(['class' => 'btn']) }}>,<div class="btn"> — drops extra class/id from caller,High,https://laravel.com/docs/blade#component-attributes
|
||||||
|
31,Components,Separate variant logic from templates,Keep variant/size/color logic in a PHP class or helper not in Blade,Variant class or match() expression in component class,Long @if chains for variants inside Blade templates,"public function classes(): string { return match($this->variant) { 'primary' => 'bg-blue-600', } }","@if($variant === 'primary') bg-blue-600 @elseif($variant === 'secondary')...",Medium,https://laravel.com/docs/blade#components
|
||||||
|
32,Components,Provide default slot content,Use {{ $slot ?? '' }} or named slot defaults so components are usable empty,Default content in slots for optional regions,Require every slot to be filled — throws errors on empty usage,{{ $icon ?? '' }} in component Blade file,{{ $icon }} — fatal if caller omits slot,Low,https://laravel.com/docs/blade#slots
|
||||||
|
33,Components,Use component namespacing for packages,Prefix third-party or module components to avoid collisions,Register custom prefix via Blade::componentNamespace(),Mix first-party and package component names with no prefix,Blade::componentNamespace('Modules\\Shop\\Views' 'shop'); <x-shop::product-card />,<x-product-card /> colliding with first-party card,Low,https://laravel.com/docs/blade#manually-registering-components
|
||||||
|
34,Forms,Validate with Form Request classes,Move validation rules out of controllers into dedicated FormRequest classes,php artisan make:request and define rules() + authorize(),Inline validate() in controller actions,class StorePostRequest extends FormRequest { public function rules() { return ['title' => 'required|max:255']; } },public function store(Request $r) { $r->validate(['title' => 'required']); },High,https://laravel.com/docs/validation#form-request-validation
|
||||||
|
35,Forms,Preserve old input on validation failure,Use old() to repopulate form fields after server-side error redirect,old('field') as default value on all form inputs,Empty form fields when validation fails,<input name="email" value="{{ old('email') }}">,<input name="email">,High,https://laravel.com/docs/validation#repopulating-forms
|
||||||
|
36,Forms,Display validation errors with @error,Use the @error directive for inline field-level error messages,@error('field') to show per-field messages,Dump $errors->all() in one block at top of form,@error('email') <p class="text-red-500">{{ $message }}</p> @enderror,@foreach($errors->all() as $e) {{ $e }} @endforeach,Medium,https://laravel.com/docs/validation#quick-displaying-the-validation-errors
|
||||||
|
37,Forms,Use CSRF token on all forms,CSRF protection is enabled by default — include @csrf in every form,@csrf in every POST/PUT/PATCH/DELETE form,Disable VerifyCsrfToken middleware for convenience,<form method="POST">@csrf ...,<form method="POST"> without @csrf,High,https://laravel.com/docs/csrf
|
||||||
|
38,Forms,Use method spoofing for PUT/PATCH/DELETE,HTML forms only support GET/POST — use @method for REST actions,@method('PUT') inside form for update/delete routes,Route::post for all mutations including updates,"<form method=""POST"">@csrf @method('PUT')",<form method="POST" action="/users/update">,Medium,https://laravel.com/docs/routing#form-method-spoofing
|
||||||
|
39,Forms,Display flash messages consistently,Flash success/error in controller; read in layout with session(),session('status') in layout for global flash display,Re-query DB or pass flash from every controller individually,@if(session('success')) <div class="alert">{{ session('success') }}</div> @endif,if($user) return back()->with(['user' => $user]);,Medium,https://laravel.com/docs/session#flash-data
|
||||||
|
40,Performance,Eager load relationships to prevent N+1,Always eager load related models used in views with with(),with() in queries before passing collections to views,Lazy-load relations inside Blade loops,User::with('posts' 'avatar')->get(),User::all() then @foreach $user->posts in Blade,High,https://laravel.com/docs/eloquent-relationships#eager-loading
|
||||||
|
41,Performance,Cache rendered Blade fragments,Use cache() helper to wrap expensive rendered partials,cache() around slow partials that change infrequently,Re-render identical content on every request,@php echo cache()->remember('sidebar' 3600 fn() => view('sidebar')->render()); @endphp,{{ view('sidebar')->render() }} on every page load,Medium,https://laravel.com/docs/cache
|
||||||
|
42,Performance,Paginate large data sets,Always paginate collections in list views,->paginate() or ->simplePaginate() with {{ $items->links() }},->get() for large tables in views,User::paginate(20) with <x-pagination :links="$users" />,User::all() passed to Blade,High,https://laravel.com/docs/pagination
|
||||||
|
43,Performance,Queue slow background tasks,Offload emails notifications and heavy processing to queues,Dispatch jobs for anything taking >200ms,Block HTTP request with slow operations,ProcessImage::dispatch($file); return back();,Storage::put(); Mail::send(); Image::resize(); in controller,High,https://laravel.com/docs/queues
|
||||||
|
44,Performance,Use route model binding,Laravel resolves models automatically — avoids manual find(),Type-hint model in controller method,Manual User::findOrFail($id) in every method,public function show(User $user): View { return view('users.show' compact('user')); },public function show($id) { $user = User::findOrFail($id); },Medium,https://laravel.com/docs/routing#route-model-binding
|
||||||
|
45,Performance,Enable HTTP response caching for static content,Cache control headers for pages that rarely change,Cache-Control headers via middleware for public pages,No caching — serve every response fresh,response()->view('home')->header('Cache-Control' 'public, max-age=3600'),No cache headers on marketing pages,Medium,https://laravel.com/docs/responses#response-headers
|
||||||
|
46,Security,Escape all output in Blade,{{ }} auto-escapes HTML — never use {!! !!} on user data,{{ }} for all untrusted or dynamic content,{!! !!} for user-controlled strings,{{ $comment->body }},{!! $comment->body !!},High,https://laravel.com/docs/blade#displaying-data
|
||||||
|
47,Security,Protect routes with Gate and Policy,Use policies for authorization — never inline permission checks in views,@can / Gate::allows() for UI visibility; policy()->authorize() for actions,Hardcode role checks inline across templates,@can('update' $post) <a href="{{ route('posts.edit' $post) }}">Edit</a> @endcan,@if(auth()->user()->role === 'admin') <a href="/edit">,High,https://laravel.com/docs/authorization#policies
|
||||||
|
48,Security,Validate and authorize file uploads,Check MIME type size and store outside public root,Store in storage/app/private + validate mimes and max,Store raw upload in public/ without validation,"'avatar' => ['required' 'image' 'mimes:jpg,png' 'max:2048']",'avatar' => 'required' with no MIME or size check,High,https://laravel.com/docs/filesystem#file-uploads
|
||||||
|
49,Security,Use signed URLs for temporary links,Generate expiring URLs for private downloads or email confirmations,URL::signedRoute() or temporarySignedRoute(),Expose sequential IDs in download URLs without auth,URL::temporarySignedRoute('file.download' now()->addMinutes(30) ['file' => $id]),route('file.download' $id) with no expiry or signature,High,https://laravel.com/docs/urls#signed-urls
|
||||||
|
50,Security,Set a strict Content Security Policy,CSP headers prevent XSS injection of external scripts,spatie/laravel-csp or custom middleware to emit CSP header,No CSP — browser runs any injected script,Header: Content-Security-Policy: default-src 'self'; script-src 'self',No Content-Security-Policy header on responses,Medium,https://laravel.com/docs/middleware
|
||||||
|
Can't render this file because it contains an unexpected character in line 2 and column 209.
|
18
cli/assets/templates/platforms/augment.json
Normal file
18
cli/assets/templates/platforms/augment.json
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"platform": "augment",
|
||||||
|
"displayName": "Augment",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".augment",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": null,
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
21
cli/assets/templates/platforms/kilocode.json
Normal file
21
cli/assets/templates/platforms/kilocode.json
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
{
|
||||||
|
"platform": "kilocode",
|
||||||
|
"displayName": "KiloCode",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".kilocode",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": {
|
||||||
|
"name": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks."
|
||||||
|
},
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
18
cli/assets/templates/platforms/warp.json
Normal file
18
cli/assets/templates/platforms/warp.json
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"platform": "warp",
|
||||||
|
"displayName": "Warp",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".warp",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": null,
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
18
cli/src/commands/init.ts
Normal file → Executable file
18
cli/src/commands/init.ts
Normal file → Executable file
@ -26,6 +26,7 @@ interface InitOptions {
|
|||||||
force?: boolean;
|
force?: boolean;
|
||||||
offline?: boolean;
|
offline?: boolean;
|
||||||
legacy?: boolean; // Use old ZIP-based install
|
legacy?: boolean; // Use old ZIP-based install
|
||||||
|
global?: boolean; // Install to home directory (global mode)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -99,15 +100,18 @@ async function tryGitHubInstall(
|
|||||||
async function templateInstall(
|
async function templateInstall(
|
||||||
targetDir: string,
|
targetDir: string,
|
||||||
aiType: AIType,
|
aiType: AIType,
|
||||||
spinner: ReturnType<typeof ora>
|
spinner: ReturnType<typeof ora>,
|
||||||
|
isGlobal = false
|
||||||
): Promise<string[]> {
|
): Promise<string[]> {
|
||||||
spinner.text = 'Generating skill files from templates...';
|
spinner.text = isGlobal
|
||||||
|
? 'Generating skill files globally...'
|
||||||
|
: 'Generating skill files from templates...';
|
||||||
|
|
||||||
if (aiType === 'all') {
|
if (aiType === 'all') {
|
||||||
return generateAllPlatformFiles(targetDir);
|
return generateAllPlatformFiles(targetDir, isGlobal);
|
||||||
}
|
}
|
||||||
|
|
||||||
return generatePlatformFiles(targetDir, aiType);
|
return generatePlatformFiles(targetDir, aiType, isGlobal);
|
||||||
}
|
}
|
||||||
|
|
||||||
export async function initCommand(options: InitOptions): Promise<void> {
|
export async function initCommand(options: InitOptions): Promise<void> {
|
||||||
@ -142,7 +146,9 @@ export async function initCommand(options: InitOptions): Promise<void> {
|
|||||||
aiType = response.aiType as AIType;
|
aiType = response.aiType as AIType;
|
||||||
}
|
}
|
||||||
|
|
||||||
logger.info(`Installing for: ${chalk.cyan(getAITypeDescription(aiType))}`);
|
const isGlobal = !!options.global;
|
||||||
|
const modeLabel = isGlobal ? ' (global)' : '';
|
||||||
|
logger.info(`Installing for: ${chalk.cyan(getAITypeDescription(aiType))}${modeLabel}`);
|
||||||
|
|
||||||
const spinner = ora('Installing files...').start();
|
const spinner = ora('Installing files...').start();
|
||||||
const cwd = process.cwd();
|
const cwd = process.cwd();
|
||||||
@ -169,7 +175,7 @@ export async function initCommand(options: InitOptions): Promise<void> {
|
|||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
// Use new template-based generation (default)
|
// Use new template-based generation (default)
|
||||||
copiedFolders = await templateInstall(cwd, aiType, spinner);
|
copiedFolders = await templateInstall(cwd, aiType, spinner, isGlobal);
|
||||||
installMethod = 'template';
|
installMethod = 'template';
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
133
cli/src/commands/uninstall.ts
Normal file
133
cli/src/commands/uninstall.ts
Normal file
@ -0,0 +1,133 @@
|
|||||||
|
import { rm } from 'node:fs/promises';
|
||||||
|
import { join } from 'node:path';
|
||||||
|
import { homedir } from 'node:os';
|
||||||
|
import chalk from 'chalk';
|
||||||
|
import ora from 'ora';
|
||||||
|
import prompts from 'prompts';
|
||||||
|
import type { AIType } from '../types/index.js';
|
||||||
|
import { AI_TYPES, AI_FOLDERS } from '../types/index.js';
|
||||||
|
import { detectAIType, getAITypeDescription } from '../utils/detect.js';
|
||||||
|
import { logger } from '../utils/logger.js';
|
||||||
|
|
||||||
|
interface UninstallOptions {
|
||||||
|
ai?: AIType;
|
||||||
|
global?: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove skill directory for a given AI type
|
||||||
|
*/
|
||||||
|
async function removeSkillDir(baseDir: string, aiType: Exclude<AIType, 'all'>): Promise<string[]> {
|
||||||
|
const folders = AI_FOLDERS[aiType];
|
||||||
|
const removed: string[] = [];
|
||||||
|
|
||||||
|
for (const folder of folders) {
|
||||||
|
const skillDir = join(baseDir, folder, 'skills', 'ui-ux-pro-max');
|
||||||
|
try {
|
||||||
|
await rm(skillDir, { recursive: true, force: true });
|
||||||
|
removed.push(`${folder}/skills/ui-ux-pro-max`);
|
||||||
|
} catch {
|
||||||
|
// Directory doesn't exist, skip
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return removed;
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function uninstallCommand(options: UninstallOptions): Promise<void> {
|
||||||
|
logger.title('UI/UX Pro Max Uninstaller');
|
||||||
|
|
||||||
|
const isGlobal = !!options.global;
|
||||||
|
const baseDir = isGlobal ? homedir() : process.cwd();
|
||||||
|
const locationLabel = isGlobal ? '~/ (global)' : process.cwd();
|
||||||
|
|
||||||
|
let aiType = options.ai;
|
||||||
|
|
||||||
|
// Auto-detect or prompt for AI type
|
||||||
|
if (!aiType) {
|
||||||
|
const { detected } = detectAIType(baseDir);
|
||||||
|
|
||||||
|
if (detected.length === 0) {
|
||||||
|
logger.warn('No installed AI skill directories detected.');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
logger.info(`Detected installations: ${detected.map(t => chalk.cyan(t)).join(', ')}`);
|
||||||
|
|
||||||
|
const choices = [
|
||||||
|
...detected.map(type => ({
|
||||||
|
title: getAITypeDescription(type),
|
||||||
|
value: type,
|
||||||
|
})),
|
||||||
|
{ title: 'All detected', value: 'all' as AIType },
|
||||||
|
];
|
||||||
|
|
||||||
|
const response = await prompts({
|
||||||
|
type: 'select',
|
||||||
|
name: 'aiType',
|
||||||
|
message: 'Select which AI skill to uninstall:',
|
||||||
|
choices,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!response.aiType) {
|
||||||
|
logger.warn('Uninstall cancelled');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
aiType = response.aiType as AIType;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Confirm before removing
|
||||||
|
const { confirmed } = await prompts({
|
||||||
|
type: 'confirm',
|
||||||
|
name: 'confirmed',
|
||||||
|
message: `Remove UI/UX Pro Max skill for ${chalk.cyan(getAITypeDescription(aiType))} from ${locationLabel}?`,
|
||||||
|
initial: false,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!confirmed) {
|
||||||
|
logger.warn('Uninstall cancelled');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const spinner = ora('Removing skill files...').start();
|
||||||
|
|
||||||
|
try {
|
||||||
|
const allRemoved: string[] = [];
|
||||||
|
|
||||||
|
if (aiType === 'all') {
|
||||||
|
// Remove for all detected platforms
|
||||||
|
const { detected } = detectAIType(baseDir);
|
||||||
|
for (const type of detected) {
|
||||||
|
const removed = await removeSkillDir(baseDir, type);
|
||||||
|
allRemoved.push(...removed);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
const removed = await removeSkillDir(baseDir, aiType);
|
||||||
|
allRemoved.push(...removed);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (allRemoved.length === 0) {
|
||||||
|
spinner.warn('No skill files found to remove');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
spinner.succeed('Skill files removed!');
|
||||||
|
|
||||||
|
console.log();
|
||||||
|
logger.info('Removed:');
|
||||||
|
allRemoved.forEach(folder => {
|
||||||
|
console.log(` ${chalk.red('-')} ${folder}`);
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log();
|
||||||
|
logger.success('UI/UX Pro Max uninstalled successfully!');
|
||||||
|
console.log();
|
||||||
|
} catch (error) {
|
||||||
|
spinner.fail('Uninstall failed');
|
||||||
|
if (error instanceof Error) {
|
||||||
|
logger.error(error.message);
|
||||||
|
}
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
}
|
||||||
20
cli/src/index.ts
Normal file → Executable file
20
cli/src/index.ts
Normal file → Executable file
@ -7,6 +7,7 @@ import { dirname, join } from 'path';
|
|||||||
import { initCommand } from './commands/init.js';
|
import { initCommand } from './commands/init.js';
|
||||||
import { versionsCommand } from './commands/versions.js';
|
import { versionsCommand } from './commands/versions.js';
|
||||||
import { updateCommand } from './commands/update.js';
|
import { updateCommand } from './commands/update.js';
|
||||||
|
import { uninstallCommand } from './commands/uninstall.js';
|
||||||
import type { AIType } from './types/index.js';
|
import type { AIType } from './types/index.js';
|
||||||
import { AI_TYPES } from './types/index.js';
|
import { AI_TYPES } from './types/index.js';
|
||||||
|
|
||||||
@ -27,6 +28,7 @@ program
|
|||||||
.option('-a, --ai <type>', `AI assistant type (${AI_TYPES.join(', ')})`)
|
.option('-a, --ai <type>', `AI assistant type (${AI_TYPES.join(', ')})`)
|
||||||
.option('-f, --force', 'Overwrite existing files')
|
.option('-f, --force', 'Overwrite existing files')
|
||||||
.option('-o, --offline', 'Skip GitHub download, use bundled assets only')
|
.option('-o, --offline', 'Skip GitHub download, use bundled assets only')
|
||||||
|
.option('-g, --global', 'Install globally to home directory (~/) instead of current project')
|
||||||
.action(async (options) => {
|
.action(async (options) => {
|
||||||
if (options.ai && !AI_TYPES.includes(options.ai)) {
|
if (options.ai && !AI_TYPES.includes(options.ai)) {
|
||||||
console.error(`Invalid AI type: ${options.ai}`);
|
console.error(`Invalid AI type: ${options.ai}`);
|
||||||
@ -37,6 +39,7 @@ program
|
|||||||
ai: options.ai as AIType | undefined,
|
ai: options.ai as AIType | undefined,
|
||||||
force: options.force,
|
force: options.force,
|
||||||
offline: options.offline,
|
offline: options.offline,
|
||||||
|
global: options.global,
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
@ -60,4 +63,21 @@ program
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
program
|
||||||
|
.command('uninstall')
|
||||||
|
.description('Remove UI/UX Pro Max skill from current project or globally')
|
||||||
|
.option('-a, --ai <type>', `AI assistant type (${AI_TYPES.join(', ')})`)
|
||||||
|
.option('-g, --global', 'Uninstall from home directory (~/) instead of current project')
|
||||||
|
.action(async (options) => {
|
||||||
|
if (options.ai && !AI_TYPES.includes(options.ai)) {
|
||||||
|
console.error(`Invalid AI type: ${options.ai}`);
|
||||||
|
console.error(`Valid types: ${AI_TYPES.join(', ')}`);
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
await uninstallCommand({
|
||||||
|
ai: options.ai as AIType | undefined,
|
||||||
|
global: options.global,
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
program.parse();
|
program.parse();
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'all';
|
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'all';
|
||||||
|
|
||||||
export type InstallType = 'full' | 'reference';
|
export type InstallType = 'full' | 'reference';
|
||||||
|
|
||||||
@ -41,7 +41,7 @@ export interface PlatformConfig {
|
|||||||
skillOrWorkflow: string;
|
skillOrWorkflow: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'all'];
|
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'all'];
|
||||||
|
|
||||||
// Legacy folder mapping for backward compatibility with ZIP-based installs
|
// Legacy folder mapping for backward compatibility with ZIP-based installs
|
||||||
export const AI_FOLDERS: Record<Exclude<AIType, 'all'>, string[]> = {
|
export const AI_FOLDERS: Record<Exclude<AIType, 'all'>, string[]> = {
|
||||||
@ -60,4 +60,7 @@ export const AI_FOLDERS: Record<Exclude<AIType, 'all'>, string[]> = {
|
|||||||
continue: ['.continue'],
|
continue: ['.continue'],
|
||||||
codebuddy: ['.codebuddy'],
|
codebuddy: ['.codebuddy'],
|
||||||
droid: ['.factory'],
|
droid: ['.factory'],
|
||||||
|
kilocode: ['.kilocode', '.shared'],
|
||||||
|
warp: ['.warp', '.shared'],
|
||||||
|
augment: ['.augment', '.shared'],
|
||||||
};
|
};
|
||||||
|
|||||||
@ -55,6 +55,15 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult {
|
|||||||
if (existsSync(join(cwd, '.factory'))) {
|
if (existsSync(join(cwd, '.factory'))) {
|
||||||
detected.push('droid');
|
detected.push('droid');
|
||||||
}
|
}
|
||||||
|
if (existsSync(join(cwd, '.kilocode'))) {
|
||||||
|
detected.push('kilocode');
|
||||||
|
}
|
||||||
|
if (existsSync(join(cwd, '.warp'))) {
|
||||||
|
detected.push('warp');
|
||||||
|
}
|
||||||
|
if (existsSync(join(cwd, '.augment'))) {
|
||||||
|
detected.push('augment');
|
||||||
|
}
|
||||||
|
|
||||||
// Suggest based on what's detected
|
// Suggest based on what's detected
|
||||||
let suggested: AIType | null = null;
|
let suggested: AIType | null = null;
|
||||||
@ -99,6 +108,12 @@ export function getAITypeDescription(aiType: AIType): string {
|
|||||||
return 'CodeBuddy (.codebuddy/skills/)';
|
return 'CodeBuddy (.codebuddy/skills/)';
|
||||||
case 'droid':
|
case 'droid':
|
||||||
return 'Droid (Factory) (.factory/skills/)';
|
return 'Droid (Factory) (.factory/skills/)';
|
||||||
|
case 'kilocode':
|
||||||
|
return 'KiloCode (.kilocode/skills/)';
|
||||||
|
case 'warp':
|
||||||
|
return 'Warp (.warp/skills/)';
|
||||||
|
case 'augment':
|
||||||
|
return 'Augment (.augment/skills/)';
|
||||||
case 'all':
|
case 'all':
|
||||||
return 'All AI assistants';
|
return 'All AI assistants';
|
||||||
}
|
}
|
||||||
|
|||||||
33
cli/src/utils/template.ts
Normal file → Executable file
33
cli/src/utils/template.ts
Normal file → Executable file
@ -1,5 +1,6 @@
|
|||||||
import { readFile, mkdir, writeFile, cp, access, readdir } from 'node:fs/promises';
|
import { readFile, mkdir, writeFile, cp, access, readdir } from 'node:fs/promises';
|
||||||
import { join, dirname } from 'node:path';
|
import { join, dirname } from 'node:path';
|
||||||
|
import { homedir } from 'node:os';
|
||||||
import { fileURLToPath } from 'node:url';
|
import { fileURLToPath } from 'node:url';
|
||||||
|
|
||||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||||
@ -42,6 +43,9 @@ const AI_TO_PLATFORM: Record<string, string> = {
|
|||||||
continue: 'continue',
|
continue: 'continue',
|
||||||
codebuddy: 'codebuddy',
|
codebuddy: 'codebuddy',
|
||||||
droid: 'droid',
|
droid: 'droid',
|
||||||
|
kilocode: 'kilocode',
|
||||||
|
warp: 'warp',
|
||||||
|
augment: 'augment',
|
||||||
};
|
};
|
||||||
|
|
||||||
async function exists(path: string): Promise<boolean> {
|
async function exists(path: string): Promise<boolean> {
|
||||||
@ -114,8 +118,9 @@ function renderFrontmatter(frontmatter: Record<string, string> | null): string {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Render skill file content from template
|
* Render skill file content from template
|
||||||
|
* When isGlobal=true, rewrites script paths to use ~/{root}/ prefix
|
||||||
*/
|
*/
|
||||||
export async function renderSkillFile(config: PlatformConfig): Promise<string> {
|
export async function renderSkillFile(config: PlatformConfig, isGlobal = false): Promise<string> {
|
||||||
// Load base template
|
// Load base template
|
||||||
let content = await loadTemplate('base/skill-content.md');
|
let content = await loadTemplate('base/skill-content.md');
|
||||||
|
|
||||||
@ -139,6 +144,15 @@ export async function renderSkillFile(config: PlatformConfig): Promise<string> {
|
|||||||
.replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
|
.replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
|
||||||
.replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);
|
.replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);
|
||||||
|
|
||||||
|
// For global install, rewrite relative script paths to absolute ~/root/ paths
|
||||||
|
if (isGlobal) {
|
||||||
|
const globalPrefix = `~/${config.folderStructure.root}/`;
|
||||||
|
content = content.replace(
|
||||||
|
/python3 skills\//g,
|
||||||
|
`python3 ${globalPrefix}skills/`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
return frontmatter + content;
|
return frontmatter + content;
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -168,17 +182,22 @@ async function copyDataAndScripts(targetSkillDir: string): Promise<void> {
|
|||||||
/**
|
/**
|
||||||
* Generate platform files for a specific AI type
|
* Generate platform files for a specific AI type
|
||||||
* All platforms use self-contained installation with data and scripts
|
* All platforms use self-contained installation with data and scripts
|
||||||
|
* When isGlobal=true, installs to ~/home directory with absolute script paths
|
||||||
*/
|
*/
|
||||||
export async function generatePlatformFiles(
|
export async function generatePlatformFiles(
|
||||||
targetDir: string,
|
targetDir: string,
|
||||||
aiType: string
|
aiType: string,
|
||||||
|
isGlobal = false
|
||||||
): Promise<string[]> {
|
): Promise<string[]> {
|
||||||
const config = await loadPlatformConfig(aiType);
|
const config = await loadPlatformConfig(aiType);
|
||||||
const createdFolders: string[] = [];
|
const createdFolders: string[] = [];
|
||||||
|
|
||||||
|
// For global install, target the user's home directory
|
||||||
|
const effectiveDir = isGlobal ? homedir() : targetDir;
|
||||||
|
|
||||||
// Determine full skill directory path
|
// Determine full skill directory path
|
||||||
const skillDir = join(
|
const skillDir = join(
|
||||||
targetDir,
|
effectiveDir,
|
||||||
config.folderStructure.root,
|
config.folderStructure.root,
|
||||||
config.folderStructure.skillPath
|
config.folderStructure.skillPath
|
||||||
);
|
);
|
||||||
@ -186,8 +205,8 @@ export async function generatePlatformFiles(
|
|||||||
// Create directory structure
|
// Create directory structure
|
||||||
await mkdir(skillDir, { recursive: true });
|
await mkdir(skillDir, { recursive: true });
|
||||||
|
|
||||||
// Render and write skill file
|
// Render and write skill file (pass isGlobal to adjust paths)
|
||||||
const skillContent = await renderSkillFile(config);
|
const skillContent = await renderSkillFile(config, isGlobal);
|
||||||
const skillFilePath = join(skillDir, config.folderStructure.filename);
|
const skillFilePath = join(skillDir, config.folderStructure.filename);
|
||||||
await writeFile(skillFilePath, skillContent, 'utf-8');
|
await writeFile(skillFilePath, skillContent, 'utf-8');
|
||||||
createdFolders.push(config.folderStructure.root);
|
createdFolders.push(config.folderStructure.root);
|
||||||
@ -201,12 +220,12 @@ export async function generatePlatformFiles(
|
|||||||
/**
|
/**
|
||||||
* Generate files for all AI types
|
* Generate files for all AI types
|
||||||
*/
|
*/
|
||||||
export async function generateAllPlatformFiles(targetDir: string): Promise<string[]> {
|
export async function generateAllPlatformFiles(targetDir: string, isGlobal = false): Promise<string[]> {
|
||||||
const allFolders = new Set<string>();
|
const allFolders = new Set<string>();
|
||||||
|
|
||||||
for (const aiType of Object.keys(AI_TO_PLATFORM)) {
|
for (const aiType of Object.keys(AI_TO_PLATFORM)) {
|
||||||
try {
|
try {
|
||||||
const folders = await generatePlatformFiles(targetDir, aiType);
|
const folders = await generatePlatformFiles(targetDir, aiType, isGlobal);
|
||||||
folders.forEach(f => allFolders.add(f));
|
folders.forEach(f => allFolders.add(f));
|
||||||
} catch {
|
} catch {
|
||||||
// Skip if generation fails for a platform
|
// Skip if generation fails for a platform
|
||||||
|
|||||||
41
skill.json
Normal file
41
skill.json
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
{
|
||||||
|
"name": "ui-ux-pro-max",
|
||||||
|
"displayName": "UI/UX Pro Max",
|
||||||
|
"description": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.",
|
||||||
|
"version": "2.0.0",
|
||||||
|
"author": "NextLevelBuilder",
|
||||||
|
"license": "MIT",
|
||||||
|
"homepage": "https://uupm.cc",
|
||||||
|
"repository": "https://github.com/nextlevelbuilder/ui-ux-pro-max-skill",
|
||||||
|
"keywords": [
|
||||||
|
"ui",
|
||||||
|
"ux",
|
||||||
|
"design",
|
||||||
|
"design-system",
|
||||||
|
"color-palette",
|
||||||
|
"typography",
|
||||||
|
"accessibility",
|
||||||
|
"ai-skill"
|
||||||
|
],
|
||||||
|
"platforms": [
|
||||||
|
"claude",
|
||||||
|
"cursor",
|
||||||
|
"windsurf",
|
||||||
|
"copilot",
|
||||||
|
"kiro",
|
||||||
|
"roocode",
|
||||||
|
"kilocode",
|
||||||
|
"codex",
|
||||||
|
"qoder",
|
||||||
|
"gemini",
|
||||||
|
"trae",
|
||||||
|
"opencode",
|
||||||
|
"continue",
|
||||||
|
"codebuddy",
|
||||||
|
"droid",
|
||||||
|
"warp",
|
||||||
|
"augment",
|
||||||
|
"antigravity"
|
||||||
|
],
|
||||||
|
"install": "npx uipro-cli init --ai {{platform}}"
|
||||||
|
}
|
||||||
51
src/ui-ux-pro-max/data/stacks/angular.csv
Normal file
51
src/ui-ux-pro-max/data/stacks/angular.csv
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
|
||||||
|
1,Components,Use standalone components,Angular 17+ default; no NgModule needed,Standalone components for all new code,NgModule-based components for new projects,"@Component({ standalone: true imports: [CommonModule] })","@NgModule({ declarations: [MyComp] })",High,https://angular.dev/guide/components/importing
|
||||||
|
2,Components,Use signals for state,Signals are Angular's reactive primitive for fine-grained reactivity,Signals for component state over class properties,Mutable class properties without signals,"count = signal(0); increment() { this.count.update(v => v + 1) }","count = 0; increment() { this.count++ }",High,https://angular.dev/guide/signals
|
||||||
|
3,Components,Use @if/@for/@switch control flow,Built-in control flow syntax replaces *ngIf/*ngFor directives,@if and @for in templates,*ngIf and *ngFor structural directives,"@if (isLoggedIn) { <Dashboard /> } @else { <Login /> }","<div *ngIf=""isLoggedIn""><Dashboard /></div>",High,https://angular.dev/guide/templates/control-flow
|
||||||
|
4,Components,Use input() and output() signals,Signal-based inputs/outputs replace @Input()/@Output() decorators,input() and output() for component API,@Input() and @Output() decorators,"name = input<string>(); clicked = output<void>()","@Input() name: string; @Output() clicked = new EventEmitter()",High,https://angular.dev/guide/components/inputs
|
||||||
|
5,Components,Use content projection,ng-content for flexible component composition,ng-content with select for named slots,Rigid templates that can't be customized,"<ng-content select=""[header]"" /> <ng-content />","<div class=""header"">{{ title }}</div>",Medium,https://angular.dev/guide/components/content-projection
|
||||||
|
6,Components,Keep components small,Single responsibility; components should do one thing,Extract sub-components when template exceeds 50 lines,Monolithic components handling multiple concerns,"<UserAvatar /> <UserDetails /> <UserActions />",One 300-line component template,Medium,https://angular.dev/guide/components
|
||||||
|
7,Components,Use OnPush change detection,Reduces re-renders by only checking on input changes or signal updates,OnPush for all components,Default change detection strategy,"changeDetection: ChangeDetectionStrategy.OnPush","changeDetection: ChangeDetectionStrategy.Default",High,https://angular.dev/guide/components/lifecycle
|
||||||
|
8,Components,Avoid direct DOM manipulation,Use renderer or ElementRef sparingly; prefer template bindings,Template bindings and Angular directives,Direct document.querySelector or innerHTML,"[class.active]=""isActive""","this.el.nativeElement.classList.add('active')",High,https://angular.dev/guide/components/host-elements
|
||||||
|
9,Routing,Lazy load feature routes,Load route chunks on demand to reduce initial bundle,loadComponent() for all feature routes,Eager-loaded routes in app config,"{ path: 'admin' loadComponent: () => import('./admin/admin.component') }","{ path: 'admin' component: AdminComponent }",High,https://angular.dev/guide/routing/lazy-loading
|
||||||
|
10,Routing,Use route guards with functional API,Protect routes with canActivate/canMatch functional guards,Functional guards returning boolean or UrlTree,Class-based guards with CanActivate interface,"canActivate: [() => inject(AuthService).isLoggedIn()]","canActivate: [AuthGuard]",High,https://angular.dev/guide/routing/common-router-tasks#preventing-unauthorized-access
|
||||||
|
11,Routing,Use route resolvers for data,Pre-fetch data before route activation using resolve,ResolveFn for route data,Fetching data in ngOnInit causing flash of empty state,"resolve: { user: () => inject(UserService).getUser() }",Fetch in ngOnInit with loading state flickering,Medium,https://angular.dev/guide/routing/common-router-tasks#resolve
|
||||||
|
12,Routing,Type route params with inject,Use inject(ActivatedRoute) with signals or toSignal,Typed route params via ActivatedRoute,Untyped route.snapshot.params string access,"const id = toSignal(route.paramMap.pipe(map(p => p.get('id'))))","const id = this.route.snapshot.params['id']",Medium,https://angular.dev/api/router/ActivatedRoute
|
||||||
|
13,Routing,Use nested routes for layouts,Compose shared layouts using router-outlet nesting,Nested routes with shared layout components,Duplicating layout code across routes,"{ path: 'app' component: ShellComponent children: [...] }",Duplicate header/sidebar in each route component,Medium,https://angular.dev/guide/routing/router-tutorial-toh#child-route-configuration
|
||||||
|
14,Routing,Configure preloading strategies,Preload lazy modules in background after initial load,PreloadAllModules or custom strategy,No preloading causing delayed navigation,"provideRouter(routes withPreloading(PreloadAllModules))","provideRouter(routes)",Low,https://angular.dev/api/router/PreloadAllModules
|
||||||
|
15,State,Use signals for local state,Signals provide synchronous reactive state without RxJS overhead,signal() for component-local reactive state,BehaviorSubject for simple local state,"const items = signal<Item[]>([]); addItem(i: Item) { this.items.update(arr => [...arr i]) }","items$ = new BehaviorSubject<Item[]>([])",High,https://angular.dev/guide/signals
|
||||||
|
16,State,Use computed() for derived state,Lazily evaluated derived values that update when dependencies change,computed() for values derived from other signals,Duplicated state or manual sync,"readonly total = computed(() => this.items().reduce((s i) => s + i.price 0))","this.total = this.items.reduce(...) // called manually",High,https://angular.dev/guide/signals#computed-signals
|
||||||
|
17,State,Use effect() carefully,Effects run side effects when signals change; avoid overuse,effect() for side effects like logging or localStorage sync,effect() for deriving state (use computed instead),"effect(() => localStorage.setItem('cart' JSON.stringify(this.cart())))","effect(() => { this.total.set(this.items().length) })",Medium,https://angular.dev/guide/signals#effects
|
||||||
|
18,State,Use NgRx Signal Store for complex state,NgRx Signal Store is the modern lightweight state management for Angular,@ngrx/signals SignalStore for feature state,Full NgRx reducer/action/effect boilerplate for simple state,"const Store = signalStore(withState({ count: 0 }) withMethods(s => ({ increment: () => patchState(s { count: s.count() + 1 }) })))","createReducer(on(increment state => ({ ...state count: state.count + 1 })))",Medium,https://ngrx.io/guide/signals
|
||||||
|
19,State,Inject services for shared state,Services with signals share state across components without a store,Injectable service with signals for cross-component state,Prop drilling or @Input chains for shared state,"@Injectable({ providedIn: 'root' }) class CartService { items = signal<Item[]>([]) }","@Input() cartItems passed through 4 component levels",Medium,https://angular.dev/guide/di/creating-injectable-service
|
||||||
|
20,State,Avoid mixing RxJS and signals unnecessarily,Use toSignal() to bridge RxJS into signal world at the boundary,toSignal() to convert observable to signal at component edge,Subscribing in components and storing in signal manually,"readonly user = toSignal(this.userService.user$)","this.userService.user$.subscribe(u => this.user.set(u))",Medium,https://angular.dev/guide/rxjs-interop
|
||||||
|
21,Forms,Use typed reactive forms,FormGroup/FormControl with explicit generics for compile-time safety,FormBuilder with typed controls,Untyped FormControl or any casts,"fb.group<LoginForm>({ email: fb.control('') password: fb.control('') })","new FormGroup({ email: new FormControl(null) })",High,https://angular.dev/guide/forms/typed-forms
|
||||||
|
22,Forms,Use reactive forms over template-driven,Reactive forms scale better and are fully testable,ReactiveFormsModule for all non-trivial forms,FormsModule with ngModel for complex forms,"<input [formControl]=""emailControl"" />","<input [(ngModel)]=""email"" />",Medium,https://angular.dev/guide/forms/reactive-forms
|
||||||
|
23,Forms,Write custom validators as functions,Functional validators are composable and tree-shakeable,ValidatorFn functions for custom validation,Class-based validators implementing Validator interface,"const noSpaces: ValidatorFn = ctrl => ctrl.value?.includes(' ') ? { noSpaces: true } : null","class NoSpacesValidator implements Validator { validate(c) {} }",Medium,https://angular.dev/guide/forms/form-validation#custom-validators
|
||||||
|
24,Forms,Use updateOn for performance,Control when validation runs to avoid per-keystroke validation overhead,updateOn: 'blur' or 'submit' for expensive validators,Default updateOn: 'change' for async validators,"fb.control('' { updateOn: 'blur' validators: [Validators.email] })","fb.control('' [Validators.email]) // validates on every key",Low,https://angular.dev/api/forms/AbstractControl#updateOn
|
||||||
|
25,Forms,Use FormArray for dynamic fields,FormArray manages variable-length lists of controls,FormArray for add/remove field scenarios,Manually tracking index-based controls,"get items(): FormArray { return this.form.get('items') as FormArray }","items: [FormControl] managed outside form",Medium,https://angular.dev/guide/forms/reactive-forms#using-the-formarray-class
|
||||||
|
26,Forms,Display validation errors clearly,Use form control touched and dirty states to show errors at the right time,Show errors after field is touched,Show all errors on page load,"@if (email.invalid && email.touched) { <span>Invalid email</span> }","@if (email.invalid) { <span>Invalid email</span> }",Medium,https://angular.dev/guide/forms/form-validation
|
||||||
|
27,Performance,Apply OnPush to all components,OnPush + signals eliminates most unnecessary change detection cycles,OnPush change detection everywhere,Default strategy which checks entire tree on every event,changeDetection: ChangeDetectionStrategy.OnPush,changeDetection: ChangeDetectionStrategy.Default,High,https://angular.dev/best-practices/skipping-component-subtrees
|
||||||
|
28,Performance,Use trackBy in @for blocks,Stable identity for list items prevents full DOM re-creation on change,track item.id in @for,"@for (item of items; track item.id) { <li>{{ item.name }}</li> }","@for (item of items; track $index) { <li>{{ item.name }}</li> }",High,https://angular.dev/guide/templates/control-flow#track-and-identity
|
||||||
|
29,Performance,Use @defer for below-the-fold content,Defer blocks lazy-load components when they enter the viewport,@defer with on viewport for non-critical UI,Eagerly loading all components at startup,"@defer (on viewport) { <HeavyChart /> } @placeholder { <Skeleton /> }","<HeavyChart /> loaded at startup",High,https://angular.dev/guide/defer
|
||||||
|
30,Performance,Use NgOptimizedImage,Enforces image best practices: lazy loading LCP hints and proper sizing,NgOptimizedImage for all img tags,Plain img tags for CMS or user content,"<img ngSrc=""/hero.jpg"" width=""800"" height=""400"" priority />","<img src=""/hero.jpg"" />",High,https://angular.dev/guide/image-optimization
|
||||||
|
31,Performance,Tree-shake unused Angular features,Import only what you use from Angular packages,Import specific Angular modules needed,Import BrowserAnimationsModule when not using animations,"import { NgOptimizedImage } from '@angular/common'","import { CommonModule } from '@angular/common' // entire module",Medium,https://angular.dev/tools/cli/build
|
||||||
|
32,Performance,Avoid subscribe in components,Subscriptions leak and cause bugs; prefer async pipe or toSignal,toSignal() or async pipe instead of manual subscribe,Manual subscribe without unsubscribe in ngOnDestroy,"readonly data = toSignal(this.service.data$)","this.service.data$.subscribe(d => this.data = d)",High,https://angular.dev/guide/rxjs-interop
|
||||||
|
33,Performance,Use SSR with Angular Universal,Pre-render pages for faster LCP and better SEO,SSR or SSG for public-facing routes,Pure CSR for SEO-critical pages,"ng add @angular/ssr","// no SSR, client renders empty shell",Medium,https://angular.dev/guide/ssr
|
||||||
|
34,Performance,Minimize bundle with standalone APIs,Standalone components + provideRouter() eliminate dead NgModule code,provideRouter() and provideHttpClient() in app.config,Root AppModule with all imports,provideRouter(routes) in app.config.ts,"@NgModule({ imports: [RouterModule.forRoot(routes)] })",Medium,https://angular.dev/guide/routing/standalone
|
||||||
|
35,Testing,Use TestBed for component tests,TestBed sets up Angular DI for realistic component testing,TestBed.configureTestingModule for component tests,Instantiate components with new keyword,"TestBed.configureTestingModule({ imports: [MyComponent] })","const comp = new MyComponent()",High,https://angular.dev/guide/testing/components-basics
|
||||||
|
36,Testing,Use Angular CDK component harnesses,Harnesses provide a stable testing API that survives template refactors,MatButtonHarness and custom HarnessLoader,Direct native element queries that break on template changes,"const btn = await loader.getHarness(MatButtonHarness)","fixture.debugElement.query(By.css('button'))",Medium,https://material.angular.io/cdk/test-harnesses/overview
|
||||||
|
37,Testing,Use Spectator for less boilerplate,Spectator wraps TestBed with a cleaner API reducing test setup noise,Spectator for unit tests,Raw TestBed for every test,"const spectator = createComponentFactory(MyComponent)","TestBed.configureTestingModule({ declarations: [MyComponent] providers: [...] })",Low,https://github.com/ngneat/spectator
|
||||||
|
38,Testing,Mock services with jasmine.createSpyObj,Isolate unit tests by providing mock implementations of dependencies,SpyObj or jest.fn() mocks for services,Real HTTP calls in unit tests,"const spy = jasmine.createSpyObj('UserService' ['getUser']); spy.getUser.and.returnValue(of(user))","providers: [UserService] // real service in unit test",High,https://angular.dev/guide/testing/services
|
||||||
|
39,Testing,Write integration tests for routes,Test full route navigation including guards and resolvers,RouterTestingHarness for route integration tests,Mock all routing behavior in unit tests,"const harness = await RouterTestingHarness.create(); await harness.navigateByUrl('/home')","// manually calling route guard methods",Medium,https://angular.dev/api/router/testing/RouterTestingHarness
|
||||||
|
40,Testing,Test signal-based components,Signals update synchronously; no async flush needed in most cases,Read signal value directly in test assertions,TestBed.tick() or fakeAsync for signal reads,"component.count.set(5); expect(component.double()).toBe(10)","fakeAsync(() => { component.count.set(5); tick(); expect(component.double()).toBe(10) })",Medium,https://angular.dev/guide/testing
|
||||||
|
41,Styling,Use ViewEncapsulation.Emulated,Default emulation scopes styles to component preventing global leaks,Emulated or None for intentional global styles,ViewEncapsulation.None for component-specific styles,ViewEncapsulation.Emulated (default),ViewEncapsulation.None on feature components,Medium,https://angular.dev/guide/components/styling#style-scoping
|
||||||
|
42,Styling,Use :host selector,Style the component's host element using :host pseudo-class,":host for host element styles",Adding wrapper div just for styling,":host { display: block; padding: 1rem }","<div class=""wrapper"">...</div> + .wrapper { padding: 1rem }",Medium,https://angular.dev/guide/components/styling#host-element
|
||||||
|
43,Styling,Use CSS custom properties for theming,CSS variables work across component boundaries and enable dynamic theming,CSS custom properties for colors and spacing,Hardcoded hex values in component styles,":root { --primary: #6200ee } button { background: var(--primary) }","button { background: #6200ee }",Medium,https://angular.dev/guide/components/styling
|
||||||
|
44,Styling,Integrate Tailwind with Angular,Tailwind utilities work alongside Angular's ViewEncapsulation via global stylesheet,Add Tailwind in styles.css and use utility classes in templates,Custom CSS for layout that Tailwind already handles,"<div class=""flex items-center gap-4 p-6"">","<div class=""my-custom-flex""> /* .my-custom-flex { display: flex } */",Low,https://tailwindcss.com/docs/guides/angular
|
||||||
|
45,Styling,Use Angular Material theming tokens,Material 3 uses design tokens for systematic theming,M3 token-based theming for Angular Material,Overriding Angular Material CSS with deep selectors,"@include mat.button-theme($my-theme)","::ng-deep .mat-button { background: red }",Medium,https://material.angular.io/guide/theming
|
||||||
|
46,Architecture,Use injection tokens for config,Provide configuration via InjectionToken for testability and flexibility,InjectionToken for environment-specific values,Importing environment.ts directly in services,"const API_URL = new InjectionToken<string>('apiUrl'); provide: [{ provide: API_URL useValue: env.apiUrl }]","constructor(private env: Environment) { this.url = env.apiUrl }",Medium,https://angular.dev/guide/di/dependency-injection-providers#using-an-injectiontoken-object
|
||||||
|
47,Architecture,Use HTTP interceptors,Intercept requests for auth headers error handling and logging,Functional interceptors with withInterceptors(),Service-level header management in every request,"withInterceptors([authInterceptor errorInterceptor])","httpClient.get(url { headers: { Authorization: token } }) in every call",High,https://angular.dev/guide/http/interceptors
|
||||||
|
48,Architecture,Organize by feature not type,Feature-based folder structure scales better than type-based,Feature folders with collocated component service and routes,Flat folders: all-components/ all-services/,"src/features/checkout/checkout.component.ts checkout.service.ts checkout.routes.ts","src/components/checkout.component.ts src/services/checkout.service.ts",Medium,https://angular.dev/style-guide#folders-by-feature-structure
|
||||||
|
49,Architecture,Use environment configurations,Separate environment values for dev staging and prod via Angular build configs,angular.json fileReplacements for env configs,Hardcoded API URLs or feature flags in source,"fileReplacements: [{ replace: environment.ts with: environment.prod.ts }]","const API = 'https://api.example.com' // hardcoded in service",High,https://angular.dev/tools/cli/environments
|
||||||
|
50,Architecture,Prefer inject() over constructor DI,inject() function is composable and works in more contexts than constructor injection,inject() for dependency injection,Constructor parameters for new code,"readonly http = inject(HttpClient); readonly router = inject(Router)","constructor(private http: HttpClient private router: Router) {}",Medium,https://angular.dev/api/core/inject
|
||||||
|
Can't render this file because it has a wrong number of fields in line 29.
|
51
src/ui-ux-pro-max/data/stacks/laravel.csv
Normal file
51
src/ui-ux-pro-max/data/stacks/laravel.csv
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
|
||||||
|
1,Blade Templates,Use Blade components for reusable UI,Extract repeated markup into named Blade components,Use x-* components with @props for all reusable UI,Duplicate HTML blocks across views,<x-card :title="$title">{{ $slot }}</x-card>,@include('card' ['title' => $title]),High,https://laravel.com/docs/blade#components
|
||||||
|
2,Blade Templates,Use layouts with @extends and @section,Define one master layout and extend it per page,@extends layout with named @section blocks,Duplicate header/footer HTML in every view,@extends('layouts.app') @section('content'),Full HTML in every view file,High,https://laravel.com/docs/blade#layouts-using-template-inheritance
|
||||||
|
3,Blade Templates,Use @props for component type-safety,Declare accepted props inside components with @props,@props with defaults to document component API,Pass arbitrary variables without declaration,@props(['title' => '' 'variant' => 'primary']),No @props declaration in component,Medium,https://laravel.com/docs/blade#component-data-and-attributes
|
||||||
|
4,Blade Templates,Use conditional CSS classes with @class,Build class strings conditionally without ternary noise,@class directive for conditional class binding,String concatenation or nested ternaries,@class(['btn' 'btn-primary' => $primary 'btn-disabled' => $disabled]),class="btn {{ $primary ? 'btn-primary' : '' }}",Medium,https://laravel.com/docs/blade#conditional-classes-and-styles
|
||||||
|
5,Blade Templates,Use named slots for flexible layouts,Named slots let callers inject content into specific regions,@slot('header') and $slot for flexible component APIs,Hard-code all sub-sections inside components,"<x-modal><x-slot:header>Title</x-slot>Body</x-modal>",<x-modal title="Title">Body with no slot control</x-modal>,Medium,https://laravel.com/docs/blade#slots
|
||||||
|
6,Blade Templates,Use Blade directives instead of raw PHP,Blade directives are readable and IDE-supported,@if @foreach @forelse @empty instead of <?php ?>,Raw PHP tags inside Blade templates,@forelse($items as $item) ... @empty <p>None</p> @endforelse,<?php foreach($items as $item): ?>,High,https://laravel.com/docs/blade#blade-directives
|
||||||
|
7,Blade Templates,Escape output with {{ }},Use double curly braces for XSS-safe output,{{ }} for all user-supplied or dynamic text,{!! !!} for untrusted data,{{ $user->name }},{!! $user->name !!},High,https://laravel.com/docs/blade#displaying-data
|
||||||
|
8,Blade Templates,Use @vite for asset loading,Vite integration handles cache busting and HMR automatically,@vite(['resources/css/app.css' 'resources/js/app.js']),Manual script/link tags with hardcoded paths,@vite(['resources/css/app.css' 'resources/js/app.js']),<link href="/css/app.css?v=123">,High,https://laravel.com/docs/vite
|
||||||
|
9,Livewire,Bind inputs with wire:model,Two-way data binding keeps component state in sync,wire:model for all form inputs managed by Livewire,Manual JavaScript listeners syncing to component,<input wire:model="email">,<input @change="$wire.email = $event.target.value">,High,https://livewire.laravel.com/docs/properties
|
||||||
|
10,Livewire,Use wire:model.live for real-time validation,Validate on input rather than only on submit,wire:model.live + #[Validate] for instant feedback,Only validate on form submit,<input wire:model.live="email"> with #[Validate('email')],<input wire:model="email"> with validate() on submit only,Medium,https://livewire.laravel.com/docs/validation
|
||||||
|
11,Livewire,Use wire:click for actions,Bind UI events to component methods cleanly,wire:click for buttons and interactive elements,JavaScript fetch calls replicating Livewire actions,<button wire:click="save">Save</button>,<button onclick="fetch('/save')">Save</button>,High,https://livewire.laravel.com/docs/actions
|
||||||
|
12,Livewire,Use lifecycle hooks appropriately,mount() for init; updated() for reactive side effects,mount() for initialization updatedFoo() for property changes,Heavy logic in render() or __construct(),public function mount(): void { $this->items = Item::all(); },public function render(): View { $this->items = Item::all(); },Medium,https://livewire.laravel.com/docs/lifecycle-hooks
|
||||||
|
13,Livewire,Use lazy loading for heavy components,Defer render of expensive components until visible,wire:init or lazy attribute on components,Load all Livewire components on page load,<livewire:analytics-chart lazy />,<livewire:analytics-chart /> with heavy DB queries on mount,Medium,https://livewire.laravel.com/docs/lazy
|
||||||
|
14,Livewire,Integrate Alpine.js for local UI state,Use Alpine.js for UI-only state that doesn't need server round-trips,x-data / x-show / x-transition for tooltips dropdowns,Livewire server calls for purely visual toggle state,<div x-data="{ open: false }"><button @click="open = !open">,<button wire:click="toggleDropdown"> for a local dropdown,Medium,https://livewire.laravel.com/docs/alpine
|
||||||
|
15,Livewire,Use wire:loading for feedback,Always indicate to users when a server action is in progress,wire:loading.attr="disabled" and wire:loading elements,Provide no feedback while Livewire request is in flight,<button wire:click="save" wire:loading.attr="disabled">Save</button>,<button wire:click="save">Save</button> with no loading state,High,https://livewire.laravel.com/docs/wire-loading
|
||||||
|
16,Livewire,Handle file uploads with WithFileUploads,Livewire's trait manages chunked upload and temp storage,WithFileUploads trait + wire:model for file inputs,Manual multipart form submissions for Livewire pages,use WithFileUploads; public $photo; <input wire:model="photo" type="file">,<form action="/upload" method="POST" enctype="multipart/form-data">,Medium,https://livewire.laravel.com/docs/uploads
|
||||||
|
17,Inertia.js,Use Inertia page components as route endpoints,Each page is a Vue/React component rendered server-side via Inertia::render(),Inertia::render('Dashboard' ['data' => $data]) in controllers,Return JSON and fetch from JavaScript,return Inertia::render('Users/Index' ['users' => $users]);,return response()->json($users); with client-side fetch,High,https://inertiajs.com/responses
|
||||||
|
18,Inertia.js,Share global data via HandleInertiaRequests,Middleware share() provides auth user and flash to every page,Share auth/flash in HandleInertiaRequests middleware,Pass auth to every Inertia::render() call,public function share(Request $r): array { return ['auth' => ['user' => $r->user()]]; },Inertia::render('Page' ['auth' => auth()->user()]) every controller,High,https://inertiajs.com/shared-data
|
||||||
|
19,Inertia.js,Use <Link> for client-side navigation,Inertia Link intercepts clicks for SPA-like transitions,<Link href="/dashboard"> instead of <a href>,Regular <a> tags for internal navigation,<Link href={route('dashboard')}>Dashboard</Link>,<a href="/dashboard">Dashboard</a>,High,https://inertiajs.com/links
|
||||||
|
20,Inertia.js,Use useForm for form state and submission,Inertia's useForm manages progress errors and transforms,"useForm for all page-level forms, form.post() for submit",Axios/fetch for form submissions on Inertia pages,"const form = useForm({ name: '' }); form.post('/users');","axios.post('/users', { name });",High,https://inertiajs.com/forms
|
||||||
|
21,Inertia.js,Use persistent layouts to preserve state,Wrap pages in a persistent layout so header/sidebar don't remount,layout property on page component for persistent UI,Re-render full layout on every page visit,MyPage.layout = (page) => <AppLayout>{page}</AppLayout>,No layout — full page reload feel on navigation,Medium,https://inertiajs.com/pages#persistent-layouts
|
||||||
|
22,Inertia.js,Enable SSR for public pages,Server-side rendering improves SEO and first paint,Enable Inertia SSR for marketing and public pages,Client-only rendering for all pages including public,php artisan inertia:start-ssr with @inertiaHead,No SSR on pages requiring good SEO,Medium,https://inertiajs.com/server-side-rendering
|
||||||
|
23,Styling,Set up Tailwind CSS via Vite,Use Vite + tailwindcss plugin for fast HMR and optimized builds,Install tailwindcss @tailwindcss/vite and configure vite.config.js,Laravel Mix or manual PostCSS pipeline for new projects,plugins: [tailwindcss()] in vite.config.js + @import 'tailwindcss' in app.css,Laravel Mix with require('tailwindcss') in webpack,High,https://tailwindcss.com/docs/installation/framework-guides
|
||||||
|
24,Styling,Purge unused styles via content config,Tailwind scans Blade and JS files to tree-shake unused classes,content: ['./resources/views/**/*.blade.php' './resources/js/**/*.{js,vue}'],No content config — ship all 3MB of CSS,content: ['./resources/**/*.blade.php' './resources/**/*.js'],content: [],High,https://tailwindcss.com/docs/content-configuration
|
||||||
|
25,Styling,Use dark mode class strategy,class-based dark mode integrates with server-rendered preference,darkMode: 'class' with a toggle that sets class on <html>,Media query only — no user override possible,darkMode: 'class'; document.documentElement.classList.toggle('dark'),darkMode: 'media' — no programmatic control,Medium,https://tailwindcss.com/docs/dark-mode
|
||||||
|
26,Styling,Use @apply sparingly in component CSS,Extract only truly repeated multi-class patterns,@apply for BEM base classes shared across many components,@apply for every single element — defeats Tailwind's purpose,@apply flex items-center gap-2 (shared button base),@apply text-sm for a single use,Low,https://tailwindcss.com/docs/functions-and-directives#apply
|
||||||
|
27,Styling,Configure custom design tokens in CSS,Define brand colors spacing fonts as CSS variables consumed by Tailwind,Custom @theme tokens matched to brand guidelines,Magic color hex codes scattered across Blade templates,@theme { --color-brand: oklch(0.6 0.2 250); },bg-[#1a2b3c] inline throughout templates,Medium,https://tailwindcss.com/docs/theme
|
||||||
|
28,Components,Use anonymous Blade components for UI primitives,Blade files in resources/views/components/ auto-register as x-* components,Anonymous components for buttons alerts badges cards,Blade @includes for anything reusable,<x-badge variant="success">Active</x-badge>,@include('partials.badge' ['variant' => 'success']),Medium,https://laravel.com/docs/blade#anonymous-components
|
||||||
|
29,Components,Use class-based components for complex logic,PHP class components can inject services and pre-process data,app/View/Components/ class when component needs PHP logic,Blade @php blocks for business logic inside templates,class AlertComponent { public function __construct(public string $type) {} },@php $color = $type === 'error' ? 'red' : 'green'; @endphp,Medium,https://laravel.com/docs/blade#components
|
||||||
|
30,Components,Forward extra attributes with $attributes,Pass through HTML attributes like class id aria to root element,$attributes->merge() on root element of components,Ignore caller-provided HTML attributes silently,<div {{ $attributes->merge(['class' => 'btn']) }}>,<div class="btn"> — drops extra class/id from caller,High,https://laravel.com/docs/blade#component-attributes
|
||||||
|
31,Components,Separate variant logic from templates,Keep variant/size/color logic in a PHP class or helper not in Blade,Variant class or match() expression in component class,Long @if chains for variants inside Blade templates,"public function classes(): string { return match($this->variant) { 'primary' => 'bg-blue-600', } }","@if($variant === 'primary') bg-blue-600 @elseif($variant === 'secondary')...",Medium,https://laravel.com/docs/blade#components
|
||||||
|
32,Components,Provide default slot content,Use {{ $slot ?? '' }} or named slot defaults so components are usable empty,Default content in slots for optional regions,Require every slot to be filled — throws errors on empty usage,{{ $icon ?? '' }} in component Blade file,{{ $icon }} — fatal if caller omits slot,Low,https://laravel.com/docs/blade#slots
|
||||||
|
33,Components,Use component namespacing for packages,Prefix third-party or module components to avoid collisions,Register custom prefix via Blade::componentNamespace(),Mix first-party and package component names with no prefix,Blade::componentNamespace('Modules\\Shop\\Views' 'shop'); <x-shop::product-card />,<x-product-card /> colliding with first-party card,Low,https://laravel.com/docs/blade#manually-registering-components
|
||||||
|
34,Forms,Validate with Form Request classes,Move validation rules out of controllers into dedicated FormRequest classes,php artisan make:request and define rules() + authorize(),Inline validate() in controller actions,class StorePostRequest extends FormRequest { public function rules() { return ['title' => 'required|max:255']; } },public function store(Request $r) { $r->validate(['title' => 'required']); },High,https://laravel.com/docs/validation#form-request-validation
|
||||||
|
35,Forms,Preserve old input on validation failure,Use old() to repopulate form fields after server-side error redirect,old('field') as default value on all form inputs,Empty form fields when validation fails,<input name="email" value="{{ old('email') }}">,<input name="email">,High,https://laravel.com/docs/validation#repopulating-forms
|
||||||
|
36,Forms,Display validation errors with @error,Use the @error directive for inline field-level error messages,@error('field') to show per-field messages,Dump $errors->all() in one block at top of form,@error('email') <p class="text-red-500">{{ $message }}</p> @enderror,@foreach($errors->all() as $e) {{ $e }} @endforeach,Medium,https://laravel.com/docs/validation#quick-displaying-the-validation-errors
|
||||||
|
37,Forms,Use CSRF token on all forms,CSRF protection is enabled by default — include @csrf in every form,@csrf in every POST/PUT/PATCH/DELETE form,Disable VerifyCsrfToken middleware for convenience,<form method="POST">@csrf ...,<form method="POST"> without @csrf,High,https://laravel.com/docs/csrf
|
||||||
|
38,Forms,Use method spoofing for PUT/PATCH/DELETE,HTML forms only support GET/POST — use @method for REST actions,@method('PUT') inside form for update/delete routes,Route::post for all mutations including updates,"<form method=""POST"">@csrf @method('PUT')",<form method="POST" action="/users/update">,Medium,https://laravel.com/docs/routing#form-method-spoofing
|
||||||
|
39,Forms,Display flash messages consistently,Flash success/error in controller; read in layout with session(),session('status') in layout for global flash display,Re-query DB or pass flash from every controller individually,@if(session('success')) <div class="alert">{{ session('success') }}</div> @endif,if($user) return back()->with(['user' => $user]);,Medium,https://laravel.com/docs/session#flash-data
|
||||||
|
40,Performance,Eager load relationships to prevent N+1,Always eager load related models used in views with with(),with() in queries before passing collections to views,Lazy-load relations inside Blade loops,User::with('posts' 'avatar')->get(),User::all() then @foreach $user->posts in Blade,High,https://laravel.com/docs/eloquent-relationships#eager-loading
|
||||||
|
41,Performance,Cache rendered Blade fragments,Use cache() helper to wrap expensive rendered partials,cache() around slow partials that change infrequently,Re-render identical content on every request,@php echo cache()->remember('sidebar' 3600 fn() => view('sidebar')->render()); @endphp,{{ view('sidebar')->render() }} on every page load,Medium,https://laravel.com/docs/cache
|
||||||
|
42,Performance,Paginate large data sets,Always paginate collections in list views,->paginate() or ->simplePaginate() with {{ $items->links() }},->get() for large tables in views,User::paginate(20) with <x-pagination :links="$users" />,User::all() passed to Blade,High,https://laravel.com/docs/pagination
|
||||||
|
43,Performance,Queue slow background tasks,Offload emails notifications and heavy processing to queues,Dispatch jobs for anything taking >200ms,Block HTTP request with slow operations,ProcessImage::dispatch($file); return back();,Storage::put(); Mail::send(); Image::resize(); in controller,High,https://laravel.com/docs/queues
|
||||||
|
44,Performance,Use route model binding,Laravel resolves models automatically — avoids manual find(),Type-hint model in controller method,Manual User::findOrFail($id) in every method,public function show(User $user): View { return view('users.show' compact('user')); },public function show($id) { $user = User::findOrFail($id); },Medium,https://laravel.com/docs/routing#route-model-binding
|
||||||
|
45,Performance,Enable HTTP response caching for static content,Cache control headers for pages that rarely change,Cache-Control headers via middleware for public pages,No caching — serve every response fresh,response()->view('home')->header('Cache-Control' 'public, max-age=3600'),No cache headers on marketing pages,Medium,https://laravel.com/docs/responses#response-headers
|
||||||
|
46,Security,Escape all output in Blade,{{ }} auto-escapes HTML — never use {!! !!} on user data,{{ }} for all untrusted or dynamic content,{!! !!} for user-controlled strings,{{ $comment->body }},{!! $comment->body !!},High,https://laravel.com/docs/blade#displaying-data
|
||||||
|
47,Security,Protect routes with Gate and Policy,Use policies for authorization — never inline permission checks in views,@can / Gate::allows() for UI visibility; policy()->authorize() for actions,Hardcode role checks inline across templates,@can('update' $post) <a href="{{ route('posts.edit' $post) }}">Edit</a> @endcan,@if(auth()->user()->role === 'admin') <a href="/edit">,High,https://laravel.com/docs/authorization#policies
|
||||||
|
48,Security,Validate and authorize file uploads,Check MIME type size and store outside public root,Store in storage/app/private + validate mimes and max,Store raw upload in public/ without validation,"'avatar' => ['required' 'image' 'mimes:jpg,png' 'max:2048']",'avatar' => 'required' with no MIME or size check,High,https://laravel.com/docs/filesystem#file-uploads
|
||||||
|
49,Security,Use signed URLs for temporary links,Generate expiring URLs for private downloads or email confirmations,URL::signedRoute() or temporarySignedRoute(),Expose sequential IDs in download URLs without auth,URL::temporarySignedRoute('file.download' now()->addMinutes(30) ['file' => $id]),route('file.download' $id) with no expiry or signature,High,https://laravel.com/docs/urls#signed-urls
|
||||||
|
50,Security,Set a strict Content Security Policy,CSP headers prevent XSS injection of external scripts,spatie/laravel-csp or custom middleware to emit CSP header,No CSP — browser runs any injected script,Header: Content-Security-Policy: default-src 'self'; script-src 'self',No Content-Security-Policy header on responses,Medium,https://laravel.com/docs/middleware
|
||||||
|
Can't render this file because it contains an unexpected character in line 2 and column 209.
|
2
src/ui-ux-pro-max/scripts/core.py
Normal file → Executable file
2
src/ui-ux-pro-max/scripts/core.py
Normal file → Executable file
@ -74,6 +74,8 @@ CSV_CONFIG = {
|
|||||||
|
|
||||||
STACK_CONFIG = {
|
STACK_CONFIG = {
|
||||||
"react-native": {"file": "stacks/react-native.csv"},
|
"react-native": {"file": "stacks/react-native.csv"},
|
||||||
|
"angular": {"file": "stacks/angular.csv"},
|
||||||
|
"laravel": {"file": "stacks/laravel.csv"},
|
||||||
}
|
}
|
||||||
|
|
||||||
# Common columns for all stacks
|
# Common columns for all stacks
|
||||||
|
|||||||
18
src/ui-ux-pro-max/templates/platforms/augment.json
Normal file
18
src/ui-ux-pro-max/templates/platforms/augment.json
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"platform": "augment",
|
||||||
|
"displayName": "Augment",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".augment",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": null,
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
21
src/ui-ux-pro-max/templates/platforms/kilocode.json
Normal file
21
src/ui-ux-pro-max/templates/platforms/kilocode.json
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
{
|
||||||
|
"platform": "kilocode",
|
||||||
|
"displayName": "KiloCode",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".kilocode",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": {
|
||||||
|
"name": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks."
|
||||||
|
},
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
18
src/ui-ux-pro-max/templates/platforms/warp.json
Normal file
18
src/ui-ux-pro-max/templates/platforms/warp.json
Normal file
@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"platform": "warp",
|
||||||
|
"displayName": "Warp",
|
||||||
|
"installType": "full",
|
||||||
|
"folderStructure": {
|
||||||
|
"root": ".warp",
|
||||||
|
"skillPath": "skills/ui-ux-pro-max",
|
||||||
|
"filename": "SKILL.md"
|
||||||
|
},
|
||||||
|
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
|
||||||
|
"frontmatter": null,
|
||||||
|
"sections": {
|
||||||
|
"quickReference": false
|
||||||
|
},
|
||||||
|
"title": "ui-ux-pro-max",
|
||||||
|
"description": "Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.",
|
||||||
|
"skillOrWorkflow": "Skill"
|
||||||
|
}
|
||||||
Loading…
x
Reference in New Issue
Block a user