## What you're building
A one-page Laravel app that lists 13 dinosaurs. Visitors vote for their favourite, and every connected browser sees the totals tick up in real time. Reverb handles the WebSocket fan-out, Inertia and Vue drive the UI, and MariaDB stores the counts.
The deployed setup uses three containers:
* A `dinosaurs` PHP app serving HTTP traffic
* A `reverb` PHP app running the WebSocket server
* A `mariadb` service for persistence
All three live in the same Upsun project and are described in a single `.upsun/config.yaml`. Adding a service later (you'll add Redis at the end) is a few extra lines of YAML and a `git push`, no provisioning steps.
## Prerequisites
Before you start, install:
* [Docker](https://docs.ddev.com/en/stable/users/install/docker-installation/)
* [DDEV](https://docs.ddev.com/en/stable/users/install/ddev-installation/)
* The [Upsun CLI](/docs/get-started#install-cli)
## Local development with DDEV
### Scaffold the project
Create the project directory and configure DDEV for Laravel:
```bash Terminal theme={null}
mkdir -p dinosaurs && cd dinosaurs
ddev config --project-type=laravel --docroot=public
```
Add the Laravel installer to the DDEV container so you can scaffold the app from inside it:
```bash Terminal theme={null}
cat <<'DOCKERFILEEND' >.ddev/web-build/Dockerfile.laravel
ARG COMPOSER_HOME=/usr/local/composer
RUN composer global require laravel/installer
RUN ln -s $COMPOSER_HOME/vendor/bin/laravel /usr/local/bin/laravel
DOCKERFILEEND
ddev start
```
### Create the Laravel project
Run the Laravel installer inside the DDEV container, targeting a temporary subdirectory:
```bash Terminal theme={null}
ddev exec laravel new temp --database=sqlite
```
Answer the prompts as follows:
| Prompt | Answer |
| -------------------------------------- | ----------------------------- |
| Update Laravel installer? | No |
| Which starter kit? | Vue |
| Authentication provider? | No authentication scaffolding |
| Testing framework? | Pest |
| Install Laravel Boost? | No |
| Run `npm install` and `npm run build`? | Yes |
Move the generated files to the project root and clean up:
```bash Terminal theme={null}
ddev exec 'rsync -rltgopD temp/ ./ && rm -rf temp'
rm -f .ddev/web-build/Dockerfile.laravel .env
```
Restart DDEV and finish the Laravel setup:
```bash Terminal theme={null}
ddev restart
ddev composer run-script post-root-package-install
ddev composer run-script post-create-project-cmd
ddev launch
```
You should now see the default Laravel welcome page in your browser.
### Initialize Git
```bash Terminal theme={null}
git init
```
## Project structure
You'll create or edit the following files:
| File | Purpose |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| Pick your favourite, votes update live for everyone!
{{ dino.description }}