Initial project setup: Docker, Makefile, scripts, plugins

2026-06-17 23:38:59 +02:00
commit c52353ac8e
10 changed files with 397 additions and 0 deletions
@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+## 0. Project specifics
+
+**Only ever write changes in this folder (travel-blog-intotheeast/) or its subfolders.**
+
+### Folder explanation
+
+- **./**: Grav CMS dev environment for intotheeast travel blog
+- **scripts/**: Server install and maintenance scripts
+- **user/**: Site content, config, pages, and theme (standalone git repo — do not modify from here)
+
+### Environment
+
+**Never read `.env`** — it contains sensitive credentials. You may pass it to commands (e.g. `docker compose`, `make`) but never read its contents directly. Ask the user if you need environment-specific information.
+
+### Remote operations
+
+Always use `make` commands for anything on the production server (`make remote-install-plugins`, `make remote-clean`, etc.) — never SSH directly since credentials live in `.env`. If a remote operation isn't covered by an existing `make` command, either ask the user to run it manually or suggest adding a new `make` command if it seems reusable.
+
+### Content sync
+
+- `make content-push` — commit and push `user/` to Gitea (triggers production pull via webhook)
+- `make content-pull` — pull latest from Gitea to local
+- `plugins.txt` is manually maintained — installing a plugin via Admin does NOT update it
+
+### User repo gitignore
+
+Only these folders are tracked in the `user/` Git repo: `pages/`, `config/`, `accounts/`, `themes/`. The `plugins/` and `data/` folders are excluded.