Skip to content

Add AGENTS.md with Cursor Cloud development instructions #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
devthomaseduardo wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add AGENTS.md with Cursor Cloud development instructions #1

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.