Local Development

​

🎨 Frontend

Install the required dependencies using your preferred package manager:

npm install

Start the Vite development server for hot-reloading:

npm run dev

Build and minify assets for production:

npm run build

​

⚡ Laravel Optimization

Optimize your Laravel application for production:

php artisan optimize

This command:

• Caches configuration
• Caches routes
• Pre-compiles views

If you’re using Filament, optimize it with:

php artisan filament:optimize

​

🛠️ Frontend Tools

​

🎯 Icons

Larasonic uses Iconify for icons. Use them in your Vue components:

<template>
  <div>
    <Icon icon="mdi:account-circle" />
  </div>
</template>

<script setup>
import { Icon } from "@iconify/vue";
</script>

​

🧩 UI Components

Larasonic leverages shadcn/vue for its UI components, which are styled with TailwindCSS and can be fully customized.

Configuration for shadcn is found in components.json

The base styles reside in resources/css/app.css Customize these components to match your brand, and the entire project will reflect those changes.

To install components in a different location than the default, use:

npx shadcn-vue@latest add --all

​

🔧 Development Tools

​

📝 Styling with Laravel Pint and Rector

Larasonic comes with opinionated code styling rules configured for Laravel Pint and Rector so you don’t have to worry about styling and uses all the latest features from PHP 8.3.

Configure Laravel Pint in pint.json and Rector in rector.php to enforce consistent code styling and formatting.

Run Pint with:

sail composer format

​

🔍 Static Analysis with PHPStan

Larasonic includes PHPStan for static code analysis at the highest level (9). The configuration is in phpstan.neon.

Run PHPStan with:

sail composer analyse

​

💡 IDE Helper (Optional)

Larasonic includes Laravel IDE Helper for better IDE support and autocompletion. Generate helper files with:

sail artisan ide-helper:generate
sail artisan ide-helper:models
sail artisan ide-helper:meta

​

🎯 Cursor Rules (Optional)

The .cursorrules file helps you customize how Cursor behaves with your codebase, improving code navigation and AI suggestions.

​

❗ Troubleshooting

​

👉 Next Steps

You are now ready to start developing your application.

Check out the Features section to learn about customizing your application to your needs.