Blogging platform with advanced tools for arts and sciences.
Update instructions
+14
+14
CLAUDE.md
+14
CLAUDE.md
···
7
7
- Never run the project directly (pnpm `dev` or `start`). I'll run any build or serve operations manually through `make` targets in a separate terminal.
8
8
- When listing a `make` target always specify all variables that need to be set like the domain or the AWS profile.
9
9
- By default, the AWS profile names for local development and AWS are `localstack` and `production`, respectively.
10
+
- `DOMAIN_NAME` is not needed for local `make` targets (only for production targets).
10
11
11
12
## Important reference material
12
13
···
33
34
pnpm build # Production build (outputs to build/client/ and build/server/)
34
35
pnpm typecheck # Regenerate React Router types then run tsc
35
36
```
37
+
38
+
## Deploying updates
39
+
40
+
| What changed | Local | Production |
41
+
|---|---|---|
42
+
| `app/` (frontend) | `AWS_PROFILE=localstack make -C infra update-local-site` | `AWS_PROFILE=production DOMAIN_NAME=lemma.pub make -C infra deploy-site` |
43
+
| `infra/api/` (Lambda) | `AWS_PROFILE=localstack make -C infra update-local-api` | `AWS_PROFILE=production make -C infra update-aws-api` |
44
+
| Both frontend + API | `AWS_PROFILE=localstack make -C infra update-local` | run the two production commands above separately |
45
+
| `infra/indexer/` | `AWS_PROFILE=localstack make -C infra run-local-indexer` | `AWS_PROFILE=production make -C infra update-aws-indexer` |
46
+
47
+
`DOMAIN_NAME` is only required for `deploy-site`. The API and indexer targets do not use it.
48
+
49
+
The indexer is a separate long-running process — `update-local` does **not** cover it. Restart it separately whenever `infra/indexer/` changes.
36
50
37
51
## Docs
38
52