This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
HappyGotchaDays.com - A Progressive Web App for pet owners to celebrate and share their dogs' and cats' adoption anniversaries ("gotcha days"). Built on Cloudflare Workers edge platform.
Current State: Fully deployed and operational at https://happygotchadays.bill-burkey.workers.dev
Critical Context: This platform is exclusively for pet (dog/cat) adoption celebrations. The term "gotcha day" is controversial in child adoption contexts. Never conflate pet and human adoption.
/api/*Frontend assets are embedded as JavaScript strings and served via the Worker itself (no separate static hosting). See
src/middleware/static.jssrc/frontend/*All tables use
TEXTINTEGER# Local development npm run dev # Start local Worker (localhost:8787) curl http://localhost:8787/health # Quick health check # Database operations npm run db:migrate:local # Apply migrations locally npm run db:migrate # Apply migrations to remote D1 wrangler d1 execute gotchadays-db --local --command="SELECT * FROM users LIMIT 5" # Query local DB wrangler d1 execute gotchadays-db --remote --command="SELECT * FROM users LIMIT 5" # Query remote DB # Testing npm test # Run all tests with Vitest npm test -- tests/unit/auth.test.js # Run specific test file npm run test:coverage # Run tests with coverage # Deployment npm run deploy # Deploy to production npm run deploy:preview # Deploy to preview environment # Secrets and configuration wrangler secret list # List configured secrets wrangler secret put JWT_SECRET # Set JWT_SECRET (prompted for value) wrangler kv:namespace list # List KV namespaces wrangler r2 bucket list # List R2 buckets
src/index.jssrc/routes/auth.jssrc/routes/pets.jssrc/routes/photos.jssrc/routes/social.jssrc/routes/search.jssrc/routes/reminders.jssrc/utils/jwt.jssrc/utils/password.jssrc/utils/id.jssrc/middleware/auth.jsauthMiddlewarec.get('user')optionalAuthsrc/middleware/static.jssrc/ai/image-analysis.jssrc/ai/content-generation.jssrc/frontend/index.html.jssrc/frontend/styles/main.css.jssrc/frontend/scripts/app.js.jssrc/frontend/manifest.json.jssrc/frontend/sw.js.jsAccessed via
c.envDBgotchadays-dbPHOTOSgotchadays-photosSESSIONSCACHEAIJWT_SECRETANALYTICSAll route files export a Hono router instance:
import { Hono } from 'hono'; export const myRoutes = new Hono(); myRoutes.get('/endpoint', async (c) => { /* handler */ });
Register in
src/index.jsapp.route('/api/prefix', myRoutes)Routes using
authMiddlewareimport { authMiddleware } from '../middleware/auth.js'; myRoutes.get('/protected', authMiddleware, async (c) => { const user = c.get('user'); // { id: string, email: string } // ... });
Use
optionalAuthAll tables use
TEXTINTEGER// Single result const user = await c.env.DB.prepare( 'SELECT * FROM users WHERE id = ?' ).bind(userId).first(); // Multiple results const pets = await c.env.DB.prepare( 'SELECT * FROM pets WHERE user_id = ?' ).bind(userId).all(); // Insert/Update/Delete const result = await c.env.DB.prepare( 'INSERT INTO pets (id, user_id, name, species, gotcha_date, created_at) VALUES (?, ?, ?, ?, ?, ?)' ).bind(id, userId, name, species, gotchaDate, timestamp).run();
// Upload with metadata await c.env.PHOTOS.put(key, fileStream, { httpMetadata: { contentType: 'image/jpeg' } }); // Retrieve const object = await c.env.PHOTOS.get(key); const arrayBuffer = await object.arrayBuffer(); // Delete await c.env.PHOTOS.delete(key);
// Image classification const result = await c.env.AI.run('@cf/microsoft/resnet-50', { image: arrayBuffer }); // Vision model const result = await c.env.AI.run('@cf/llava-hf/llava-1.5-7b-hf', { image: arrayBuffer, prompt: "Describe this pet" }); // Text generation const result = await c.env.AI.run('@cf/meta/llama-3.1-8b-instruct', { messages: [{ role: "user", content: "Generate a story..." }] });
The frontend is not separate files - it's embedded as exported strings in
.jssrc/frontend/*.jsModals are dynamically created by injecting HTML into
#modalContainercloseModal()When adding new endpoints:
src/routes/src/index.jsapp.route('/api/prefix', newRoutes)migrations/npm run db:migrate:localnpm run devnpm run deployIf frontend calls an API endpoint that doesn't exist (like
/api/auth/verifysrc/index.jsnpm run deploynpm run db:migratewrangler.tomlJWT_SECRETwrangler secret listAuthorization: Bearer <token>@cf/microsoft/resnet-50@cf/llava-hf/llava-1.5-7b-hf@cf/meta/llama-3.1-8b-instructLive URL: https://happygotchadays.bill-burkey.workers.dev GitHub: https://github.com/abandini/happygotchadays Cloudflare Account: [email protected] Worker Name:
happygotchadaysWorkflow at
.github/workflows/deploy.ymlmainCLOUDFLARE_API_TOKENCLOUDFLARE_ACCOUNT_IDtests/unit/npm test -- tests/unit/auth.test.jsauth.test.jsreminders.test.jstests/integration/tests/e2e/BROWSER_TEST.md"type": "module"camelCasePascalCaseimport { Hono } from 'hono'; import { authMiddleware } from '../middleware/auth.js'; export const myRoutes = new Hono(); // GET endpoint with auth myRoutes.get('/resource', authMiddleware, async (c) => { const user = c.get('user'); // Handler logic return c.json({ data: result }); }); // POST endpoint myRoutes.post('/resource', authMiddleware, async (c) => { const body = await c.req.json(); // Handler logic return c.json({ success: true }, 201); });
Frontend files in
src/frontend/// src/frontend/example.html.js export const exampleHTML = ` <!DOCTYPE html> <html> <!-- HTML content --> </html> `;