# Safari Lodges

TYPO3 CMS v14.3 site for Safari Lodges, managed via Composer. Custom site
package lives at `packages/sflg_sitepackage`.

## Prerequisites

* [DDEV](https://ddev.com/get-started/) (recommended)
* PHP 8.2+ / Composer, if running without DDEV

## Quickstart (DDEV)

```bash
ddev start
ddev composer install
```

Site is then available at `https://safari-lodge.ddev.site`.

DDEV config: project type `typo3`, docroot `public`, PHP 8.4, MySQL 8.0,
Apache-FPM. Note `composer.json` pins platform PHP to `8.2.0` while DDEV
runs `8.4` — be aware of this mismatch if debugging PHP version issues.

### Useful commands

```bash
ddev ssh                             # shell into the web container
ddev exec vendor/bin/typo3 <command> # run TYPO3 console (helhum/typo3-console)
ddev exec vendor/bin/typo3 setup     # interactive TYPO3 install wizard
ddev exec vendor/bin/typo3 cache:flush
```

### Without DDEV

```bash
TYPO3_CONTEXT=Development php -S localhost:8000 -t public
```

## Configuration & secrets

* Runtime config lives in `config/system/`: `settings.php` (base
  `TYPO3_CONF_VARS`) and `additional.php` (loads env vars for DB/mail via
  `getenv()`, pulls in DDEV-managed `additional.ddev.php` when running in
  DDEV's Development context — do not hand-edit that file).
* Environment variables: copy `.env.example` to `.env` (gitignored),
  consumed by `helhum/dotenv-connector` — `TYPO3_CONTEXT`, `TYPO3_DB_*`,
  `TYPO3_MAIL_*`, `TYPO3_BE_LOCKROOTPATH`.
* `packages/sflg_sitepackage` — the site package/extension, registered via
  the `repositories.packages` path repo in `composer.json`.
* `var/` and `public/_assets*`/`public/typo3temp` are generated
  runtime/cache directories, gitignored.

## Frontend assets

SCSS source: `packages/sflg_sitepackage/Resources/Private/Scss/main.scss`.
Compile with dart-sass:

```bash
ddev exec npx --yes sass packages/sflg_sitepackage/Resources/Private/Scss/main.scss \
  packages/sflg_sitepackage/Resources/Public/Css/main-compiled.css --style=compressed
```

## Next steps

* [Getting Started with TYPO3](https://docs.typo3.org/permalink/t3start:start)
* [Create a Site Package](https://docs.typo3.org/permalink/t3sitepackage:start)

## License

GPL-2.0 or later