flixcooks-website/AGENTS.md

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

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:

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.