From 5fbdc6a9a451b4c9c67168dc15fad5a6e65c8f75 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Mon, 4 May 2026 16:23:54 +0000
Subject: [PATCH] Add AGENTS.md with Cursor Cloud development instructions

Co-authored-by: Thomas Eduardo <developer.thomas@outlook.com.br>
---
 AGENTS.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..6a7a41f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,25 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+### Project overview
+
+CORE Events is a frontend-only React SPA (no backend, no database). All data is hardcoded in `constants.ts` and persisted via browser `localStorage`. See `README.md` for full feature description and design system guide.
+
+### Running the app
+
+```bash
+npm run dev     # Starts Vite dev server on http://localhost:3000
+npm run build   # Production build to dist/
+npm run preview # Preview production build
+```
+
+### Key caveats
+
+- **Node.js 20+ required** — `@vitejs/plugin-react` requires `^20.19.0 || >=22.12.0`. Node 18 produces engine warnings and may fail on future updates.
+- **No test framework** — There are no automated tests (no Jest, Vitest, Playwright, etc.) configured in this project. `npm run build` and `npx tsc --noEmit` are the closest checks available.
+- **Pre-existing TS errors** — `npx tsc --noEmit` reports errors for missing icon imports (`Wine`, `Sofa` in `pages/EventDetail.tsx`) and a missing module (`components/SectionTitle` in `pages/Legal.tsx`). These are pre-existing in the codebase and do not block `npm run build` or `npm run dev`.
+- **Tailwind CSS via CDN** — Tailwind is loaded via `<script src="https://cdn.tailwindcss.com">` in `index.html`, not as an npm dependency. Internet access is needed for styling to render properly.
+- **No `.env` file needed** — The `GEMINI_API_KEY` referenced in `vite.config.ts` is vestigial and never consumed by source code.
+- **Admin demo access** — The admin portal at `/#/admin` accepts any credentials (there is also a "Acesso Demo" button).
+- **No lint configured** — There is no ESLint or Prettier configuration in the project.