Adaptide-Reddit

Imported from hari-kancharla/Adaptide-Reddit (AGENTS.md). Install upstream with npx skills add hari-kancharla/Adaptide-Reddit. Copyright stays with the author.

You are writing a Devvit web application (ADAPTIDE) that will be executed on Reddit.com.

Tech Stack

• Frontend: Phaser 4 (expanded game view), Vite. No React.
• Backend: Node.js v22 serverless environment (Devvit), Hono. No tRPC.
• Shared: plain TypeScript types in /src/shared (the combat telemetry model).

Layout & Architecture

• /src/server: Backend Code. Runs in a secure, serverless environment.
  • index.ts: Main server entry point (Hono app) wiring /internal/menu and /internal/triggers.
  • core/post.ts: creates the ADAPTIDE custom post.
  • Access reddit and context here via @devvit/web/server. Phase 1 does not use redis.
• /src/client: Frontend Code. Executed inside an iFrame on reddit.com.
  • To add an entrypoint, create an HTML file and map it in devvit.json.
  • Entrypoints:
    • splash.html (default, inline): the lightweight cover shown in the feed. Keep it fast - it must NOT import Phaser.
    • game.html (game, expanded): the Phaser game. Heavy dependencies live here.
  • Structure: core/ (theme, balance, geometry, textures, fatal), entities/, systems/, scenes/ (Boot → MutationReveal → Combat → Result).
• /src/shared: Shared Code between client and server (telemetry.ts).

Frontend

Rules

• Instead of window.location or window.assign, use navigateTo from @devvit/web/client.

Limitations

• window.alert: Use showToast or showForm from @devvit/web/client.
• File downloads: Use clipboard API with showToast to confirm.
• Geolocation, camera, microphone, and notifications web APIs: No alternatives.
• Inline script tags inside html files: Use a separate js/ts file instead.

Commands

• npm run type-check: Check TypeScript types (tsc --build).
• npm run lint: Run ESLint.
• npm run build: Build client and server with Vite.

(There is no test runner configured in Phase 1.)

Code Style

• Prefer type aliases over interfaces when writing TypeScript.
• Prefer named exports over default exports.
• Never cast TypeScript types.

Global Rules

• You may find code that references blocks or @devvit/public-api while building a feature. Do NOT use this code; this project is configured to use Devvit web only.
• Whenever you add an endpoint for a new menu item action, ensure that you've added the corresponding mapping to devvit.json so that it is properly registered.

Docs: https://developers.reddit.com/docs/llms.txt.