Coding
PromptBeginner5 minmarkdown
Nano Banana Pro
Agent skill for nano-banana-pro
7
Guidance for contributing to "A Journey Through the Unknown". This repository contains the React front end and Firebase Cloud Functions that power the playable sci-fi adventure.
Sign in to like and favorite skills
Guidance for contributing to "A Journey Through the Unknown". This repository contains the React front end and Firebase Cloud Functions that power the playable sci-fi adventure.
.prettierrc). ├── website/ # React application, Firebase config, hosting assets │ ├── public/ # Static assets served by CRA │ ├── src/ # Front-end source (components, pages, routes) │ ├── functions/ # Firebase Cloud Functions (TypeScript + Jest) │ ├── firebase.json # Firebase hosting and emulator configuration │ ├── storage.rules # Firebase Storage security rules │ └── package.json # CRA scripts (start, build, test, deploy) ├── README.md # High-level project overview and deployment notes ├── AGENTS.md # Coding agent guidance (this document) └── .prettierrc # Repository-wide formatting rule (printWidth 120)
Commands must be executed inside
website or website/functions; there is no root-level package.json.
cd website npm install
cd website/functions npm install
npm install -g firebase-tools) and authenticate with firebase login before deploying or running emulators.website/functions/.env-template to .env and fill in OPENAI_API_KEY and SENTRY_DSN for local or production use.website/functions/src/service-account-key.json (template provided in the same folder)..env files or service account keys.website/)npm start - run the CRA development server.npm run build - create a production build (required before deploys).npm test - run Jest tests via CRA (watch mode by default).npm run deploy - deploy Hosting and Functions. Runs npm run build first.website/functions/)npm run build - compile TypeScript to build/.npm run serve - build then start the Firebase emulator for Functions.npm run test - execute Jest unit tests.npm run deploy - deploy Functions only (firebase deploy --only functions).Keep strict TypeScript checks passing in both projects (
tsconfig files enable strict mode).
.firebaserc inside website/.website/storage.rules when altering storage behavior and deploy with firebase deploy --only storage.npm run serve) during development to avoid hitting production resources.Run these before sharing work:
cd website && npm run buildcd website && npm testcd website/functions && npm run buildcd website/functions && npm testnpx prettier --write <files>any, unless interacting with untyped external data. Document assumptions with short comments when necessary.type keyword (for example, import type { Foo } from './Foo';).+.README.mdMirror existing patterns in
website/src and website/functions/src when extending the codebase. When unsure, ask for clarification rather than guessing.