Index: README.md =================================================================== --- README.md (revision c73b916e2ae6f6194b843636b1dfe224159dcc21) +++ README.md (revision 7b4643993e37ca98fdc6b08a20ae2adc0eb8d9ec) @@ -1,66 +1,38 @@ -

Laravel Logo

+# Travel Sage -

-Build Status -Total Downloads -Latest Stable Version -License -

+A web app for exploring destinations, comparing travel activities and packages, and checking weather by location. Built as a full-stack Laravel application with a MySQL-backed schema for destinations, events, activities, and user data. -## About Laravel +## Tech stack -Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as: +- **Backend:** PHP 8.2, Laravel 11 +- **Frontend:** Blade templates, Vite, Tailwind CSS, JavaScript (Axios) +- **Database:** MySQL (custom `travel_sage` schema), Eloquent ORM, Doctrine DBAL +- **Tooling:** Pest, Pint, Pail; Sail optional -- [Simple, fast routing engine](https://laravel.com/docs/routing). -- [Powerful dependency injection container](https://laravel.com/docs/container). -- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage. -- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent). -- Database agnostic [schema migrations](https://laravel.com/docs/migrations). -- [Robust background job processing](https://laravel.com/docs/queues). -- [Real-time event broadcasting](https://laravel.com/docs/broadcasting). +## Key features -Laravel is accessible, powerful, and provides tools required for large, robust applications. +- Browse and filter destinations (season, place type, popularity range) +- Per-destination pages for travel events, activities, and packages (full CRUD) +- User registration and login +- Weather view by location name +- Home dashboard: trending locations from event data, budget-friendly activities, and a chart of destinations ranked by share of low-cost activities -## Learning Laravel +## Highlights -Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. +- **SQL view:** Percentage of sub-threshold-price activities per destination; consumed via Eloquent for charts. +- **Readable URLs:** Destinations resolve by `location_name`, not numeric IDs. +- **Relations:** Tags, reviews, weather, activities, events, packages, and user ratings on destinations. -You may also try the [Laravel Bootcamp](https://bootcamp.laravel.com), where you will be guided through building a modern Laravel application from scratch. +## Setup -If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library. +1. Clone the repo and install dependencies: `composer install` and `npm install`. +2. Copy `.env.example` to `.env`, run `php artisan key:generate`, and set MySQL `DB_*` for your `travel_sage` database. +3. Run migrations: `php artisan migrate`. +4. Build assets: `npm run build` (or `npm run dev` while developing). +5. Start the app: `php artisan serve` (or use `composer run dev` to run server, queue, logs, and Vite together). -## Laravel Sponsors - -We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com). - -### Premium Partners - -- **[Vehikl](https://vehikl.com/)** -- **[Tighten Co.](https://tighten.co)** -- **[WebReinvent](https://webreinvent.com/)** -- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)** -- **[64 Robots](https://64robots.com)** -- **[Curotec](https://www.curotec.com/services/technologies/laravel/)** -- **[Cyber-Duck](https://cyber-duck.co.uk)** -- **[DevSquad](https://devsquad.com/hire-laravel-developers)** -- **[Jump24](https://jump24.co.uk)** -- **[Redberry](https://redberry.international/laravel/)** -- **[Active Logic](https://activelogic.com)** -- **[byte5](https://byte5.de)** -- **[OP.GG](https://op.gg)** - -## Contributing - -Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions). - -## Code of Conduct - -In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct). - -## Security Vulnerabilities - -If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed. +MySQL must allow creating tables and views in the configured schema. ## License -The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). +MIT