# coryd.dev

This is the source for my personal site [built using 11ty, PHP and a number of other tools](https://www.coryd.dev/colophon/).

## Local dev setup

`npm run setup`

This will generate the required `.env` file, install dependencies and configure the CLI.

Once the CLI is installed, it is invoked by running `coryd`.

## Remote dev setup

`npm run setup:dev`

This runs `setup` and generates `apache` configs, commands and php extensions to install and enable on the server.

## Local dev workflow

1. `coryd run start`
2. Open `http://localhost:8080`

This will run `eleventy --watch` and the PHP cli concurrently, allowing for an environment similar to production where both static and dynamic pages are available.

## CLI

- `coryd init`: begins a series of prompts to populate the config used by `cli download`.
- `coryd run`: presents a list of commands available to run (described below).
- `coryd tasks`: common tasks performed using the Directus API.
- `coryd jobs`: scripts and cron jobs that can be triggered manually.
- `coryd run [command]`: runs the specified command immediately.
- `coryd download`: presents prompts to download images, name them consistently and place them in the directories specified when running `cli init`.

## Commands

- `coryd run start`: primary dev command that runs `watch` and `php` concurrently.
- `coryd run watch`: watch and update when files change without running the web server.
- `coryd run php`: starts a PHP server for local development.
- `coryd run build`: builds static site output.
- `coryd run clean`: removes the `dist` and `.cache` folders.
- `coryd run update`: checks for dependency updates and updates 11ty.

## Required environment variables

```plaintext
POSTGREST_URL              # client + server + build
POSTGREST_API_KEY          # client + server + build
MASTODON_ACCESS_TOKEN      # server
MASTODON_SYNDICATION_TOKEN # server
FORWARDEMAIL_API_KEY       # server
BOOK_IMPORT_TOKEN          # server
WATCHING_IMPORT_TOKEN      # server
TMDB_API_KEY               # server
NAVIDROME_SCROBBLE_TOKEN   # server
NAVIDROME_API_URL          # server
NAVIDROME_API_TOKEN        # server
ARTIST_IMPORT_TOKEN        # server
COOLIFY_REBUILD_TOKEN      # server
COOLIFY_REBUILD_URL        # server
DIRECTUS_API_TOKEN         # cli
GIT_REPO                   # build
SERVER_URL                 # build
```