From 9f0d5e3ebb4ba27e47bc36f60365883cd6432b9d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 23 May 2026 20:34:52 +0000 Subject: [PATCH] Add AGENTS.md with Cursor Cloud development instructions Co-authored-by: LordSchmackes --- AGENTS.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..d882091 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,33 @@ +# FlixCooks Development Reference + +## Cursor Cloud specific instructions + +### Overview +FlixCooks is a vanilla PHP recipe web application with a flat-file JSON database. There are **no package managers** (no `composer.json`, no `package.json`), no build step, and no formal test framework. + +### Running the development server +```bash +php -S localhost:8000 +``` +Open http://localhost:8000 in a browser. The app serves all pages from the project root. + +### Linting +The only available lint is PHP syntax checking: +```bash +find /workspace -name "*.php" -exec php -l {} \; +``` +There are no dedicated linting tools (phpcs, phpstan, etc.) configured. + +### Testing +There is no automated test suite. Validate changes by: +1. Running `php -l` on modified files to check syntax. +2. Starting the dev server and manually verifying pages render correctly via `curl` or browser. + +### Environment configuration +- Copy `.env.example` to `.env` before running. The app gracefully handles missing/placeholder Firebase credentials — core recipe browsing works without valid Firebase keys. +- Firebase Authentication and Firestore are cloud-optional services used only for login, bookmarks, and newsletter features. + +### Key caveats +- The data layer is a flat JSON file at `data/recipes.json` — no database service is needed. +- The `.htaccess` file is only relevant when running under Apache; the PHP built-in server ignores it. +- All frontend JS libraries (GSAP, Lenis) are loaded from CDNs — no npm/yarn install is required. -- 2.54.0