79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# EscapePage — Online Escape Room
|
||
|
||
This repository contains a Symfony 7.3 (PHP >= 8.2) application for a collaborative online escape room experience.
|
||
|
||
- Start here: doc/FILES.md — quick file index.
|
||
- Development standards and workflows: doc/CONTRIBUTING.md
|
||
- All documentation is located under the doc/ directory.
|
||
|
||
## Getting Started (brief)
|
||
- Local machine (no Docker):
|
||
1. Copy `.env` to `.env.local` and set database and `APP_SECRET`.
|
||
2. Install PHP deps: `composer install`
|
||
3. Create database and run migrations (when present): `php bin/console doctrine:database:create --if-not-exists && php bin/console doctrine:migrations:migrate -n`
|
||
4. Install/import JS deps: `php bin/console importmap:install`
|
||
5. Run the server: `symfony server:start -d` (or your preferred web server)
|
||
6. Run tests: `vendor/bin/phpunit`
|
||
|
||
- With Docker:
|
||
1. From `docker/`: `docker compose up -d`
|
||
2. Install vendors inside the PHP container:
|
||
- `docker compose exec php bash`
|
||
- `composer install`
|
||
3. Initialize DB:
|
||
- `php bin/console doctrine:database:create --if-not-exists`
|
||
- `php bin/console doctrine:migrations:migrate -n`
|
||
4. App is at http://localhost:8080
|
||
|
||
## Email (Mailpit in dev, SendGrid for prod)
|
||
- Dev: a `mailer` service (Mailpit) runs in Docker.
|
||
- SMTP DSN in `.env`: `MAILER_DSN=smtp://mailer:1025`
|
||
- Mailpit UI: http://localhost:8025
|
||
- Send a test mail: `php bin/console app:mail:test you@example.com`
|
||
- Staging/Prod: use SendGrid.
|
||
- Require package (already in composer): `symfony/sendgrid-mailer`.
|
||
- Set environment variables (do NOT commit secrets):
|
||
- `MAILER_DSN=sendgrid+api://%env(SENDGRID_API_KEY)%`
|
||
- `SENDGRID_API_KEY=YOUR_REAL_KEY`
|
||
- Optional: `MAILER_FROM=no-reply@your-domain.tld`
|
||
- Alternatively via SMTP (no extra package):
|
||
- `MAILER_DSN="smtp://apikey:%env(SENDGRID_API_KEY)%@smtp.sendgrid.net:587?encryption=tls"`
|
||
|
||
Troubleshooting:
|
||
- If emails don’t appear in dev, open Mailpit at http://localhost:8025 and verify messages.
|
||
- In prod, check logs for HTTP 2xx responses from SendGrid and verify sender domain is verified in SendGrid.
|
||
|
||
## Frontend assets with Webpack Encore
|
||
We use Webpack Encore to build and minify JS/CSS from the `assets/` directory into `public/build/`.
|
||
|
||
Install Node dependencies (on your host machine):
|
||
```
|
||
npm install
|
||
```
|
||
|
||
Common commands:
|
||
```
|
||
# One-time dev build
|
||
npm run dev
|
||
|
||
# Watch & rebuild on changes
|
||
npm run watch
|
||
|
||
# Production build (minified, versioned filenames)
|
||
npm run build
|
||
```
|
||
|
||
How it’s wired:
|
||
- Entry file: `assets/app.js` (imports `assets/styles/app.css`).
|
||
- Webpack config: `webpack.config.js` outputs to `public/build/`.
|
||
- Twig template includes built assets via Encore:
|
||
- In `templates/base.html.twig`:
|
||
- `{{ encore_entry_link_tags('app') }}` (CSS)
|
||
- `{{ encore_entry_script_tags('app') }}` (JS)
|
||
|
||
Notes:
|
||
- The PHP Docker image does not include Node. Run the build commands on your host, or ask to add a Node build container if you prefer fully containerized builds.
|
||
- Built files are ignored by git except for `public/build/.gitignore` to keep the directory.
|
||
|
||
See doc/CONTRIBUTING.md for code style and more details.
|