foundation.blade.php 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. @php
  2. /** @var \Laravel\Boost\Install\GuidelineAssist $assist */
  3. @endphp
  4. # Laravel Boost Guidelines
  5. The Laravel Boost guidelines are specifically curated by Laravel maintainers for this application. These guidelines should be followed closely to ensure the best experience when building Laravel applications.
  6. ## Foundational Context
  7. This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions.
  8. - php - {{ PHP_MAJOR_VERSION }}.{{ PHP_MINOR_VERSION }}
  9. @foreach (app(\Laravel\Roster\Roster::class)->packages()->unique(fn ($package) => $package->rawName()) as $package)
  10. - {{ $package->rawName() }} ({{ $package->name() }}) - v{{ $package->majorVersion() }}
  11. @endforeach
  12. @if (! empty(config('boost.purpose')))
  13. Application purpose: {!! config('boost.purpose') !!}
  14. @endif
  15. @if($assist->hasSkillsEnabled())
  16. ## Skills Activation
  17. This project has domain-specific skills available in `**/skills/**`. You MUST activate the relevant skill whenever you work in that domain—don't wait until you're stuck.
  18. @endif
  19. ## Conventions
  20. - You must follow all existing code conventions used in this application. When creating or editing a file, check sibling files for the correct structure, approach, and naming.
  21. - Use descriptive names for variables and methods. For example, `isRegisteredForDiscounts`, not `discount()`.
  22. - Check for existing components to reuse before writing a new one.
  23. ## Verification Scripts
  24. - Do not create verification scripts or tinker when tests cover that functionality and prove they work. Unit and feature tests are more important.
  25. ## Application Structure & Architecture
  26. - Stick to existing directory structure; don't create new base folders without approval.
  27. - Do not change the application's dependencies without approval.
  28. ## Frontend Bundling
  29. - If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `{{ $assist->nodePackageManagerCommand('run build') }}`, `{{ $assist->nodePackageManagerCommand('run dev') }}`, or `{{ $assist->composerCommand('run dev') }}`. Ask them.
  30. ## Documentation Files
  31. - You must only create documentation files if explicitly requested by the user.
  32. ## Replies
  33. - Be concise in your explanations - focus on what's important rather than explaining obvious details.