bitstream/fuel-price
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ada43d222a481da7e660a79df76ff51b60d68489
fuel-price/CLAUDE.md
Ovidiu U 02d4c9d888
Some checks failed
linter / quality (push) Has been cancelled
Details
tests / ci (8.3) (push) Has been cancelled
Details
tests / ci (8.4) (push) Has been cancelled
Details
tests / ci (8.5) (push) Has been cancelled
Details
Add comprehensive project documentation and architecture guidelines 
Establishes core rules and conventions for the FuelAlert Laravel application: architecture patterns (fat services, thin controllers), database schema with partitioned station_prices table, multi-tier notification system with Vonage and OneSignal, 4-signal scoring engine for fuel price recommendations, Stripe subscription tiers, Livewire classic component structure, and Pest testing standards.
2026-04-03 16:49:19 +01:00

1.4 KiB
Raw Blame History

FuelAlert — Claude Code Instructions

UK fuel price intelligence app. Subscribers receive fill-up timing recommendations based on local price trends. Built solo by a PHP/Laravel developer.

Project overview

  • Product: "Fill up now or wait?" — local fuel price trend scoring for UK drivers
  • Monetisation: £0/mo free, £0.99/mo Basic, £2.49/mo Plus, £3.99/mo Pro
  • Stack: Laravel 11 + Livewire 3 (Volt disabled — use classic components) + Alpine.js + Tailwind CSS
  • Database: MySQL — Eloquent ORM, migrations only (no raw DDL)
  • Payments: Stripe via Laravel Cashier
  • Notifications: Laravel Notification channels — email, WhatsApp (Vonage), SMS (Vonage), push (OneSignal)
  • Queue: Laravel queues with Redis driver (notifications and polling jobs)
  • Scheduler: Laravel scheduler for Fuel Finder API polling and scoring

Key commands

php artisan serve          # Local dev server
php artisan queue:work     # Process notification jobs
php artisan schedule:run   # Run scheduled commands (cron every minute)
php artisan migrate        # Run migrations
php artisan test           # Run Pest test suite
npm run dev                # Vite asset watcher

Imports

@.claude/rules/architecture.md @.claude/rules/database.md @.claude/rules/notifications.md @.claude/rules/scoring.md @.claude/rules/payments.md @.claude/rules/livewire.md @.claude/rules/api-data.md @.claude/rules/testing.md @.claude/rules/code-style.md