← All projects

Catalog and Detail

Render an Eloquent catalog and product detail page.

Goal

This snapshot advances Quaycart Market by teaching you to render an Eloquent catalog and product detail page.

Every numbered folder is a complete app. Run this stage independently, then compare it with the previous folder.

Prerequisites

Use PHP 8.2+, Composer, Node.js 20+, npm, and Docker for MySQL stages.

Port 8004 must be free. Copy .env.example before database stages.

  • PHP and Composer
  • Node.js and npm
  • Docker from part 4 onward

Concepts

List queries eager-load categories; slug route keys produce readable product URLs.

Livewire keeps interactive UI on the server with components; Tailwind styles the storefront; Eloquent owns persistence and authorization checks.

Walkthrough

Wire Livewire catalog listing and a Blade/Livewire detail page with price and stock.

Read the example, then open the matching snapshot. The repository includes validation, CSRF, and the surrounding structure.

Product::with('category')->latest()->paginate(8);
Route::get('/products/{product:slug}', ShowProduct::class)->name('products.show');

Run and verify

Enter 05-Catalog-And-Detail, install PHP and Node dependencies, copy .env.example, migrate, seed, build assets, and serve on port 8004.

Open http://127.0.0.1:8004. From data lessons onward, Ada and Grace use password123.

docker compose up -d
git clone https://github.com/michaeldunga1/fcc-laravel-ecommerce.git
cd fcc-laravel-ecommerce/05-Catalog-And-Detail
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan storage:link
npm run build
php artisan serve --host=0.0.0.0 --port=8004

Troubleshooting

Detail 404s when the slug does not match or getRouteKeyName() is wrong.

For database failures, confirm Docker and the quaycart_NN name. Never commit .env, vendor, or node_modules.

  • Read the first exception first
  • Rebuild assets after Tailwind class changes
  • Never commit secrets

Try this

Show formatted currency from price_cents on every card.

Test a happy path and one invalid or unauthorized request.

  • Make one small change
  • Test it in the browser
  • Compare with the next snapshot only after it works

Related tutorials