This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

This is a Val Town project that implements a cross-origin likes tracking API with the following structure:

• Val Town Platform: Built specifically for Val Town's serverless environment using Deno runtime
• Backend: Hono web framework with SQLite database for likes tracking across multiple websites
• API Service: RESTful endpoints with CORS support for cross-origin requests
• Entry Point: index.ts exports app.fetch as the HTTP handler

• Uses Val Town's hosted SQLite service (stevekrouse/sqlite)
• Table versioning pattern: website_likes_v1 (increment version when changing schema)
• Core functions: initDatabase(), recordLike(), getAllLikes(), getLikeCount(), getTotalLikes()
• Database tracks likes by website and optional page URL
• Database initializes automatically on startup

• Self-contained HTML documentation page
• Shows API endpoints and usage examples
• No longer a tracking frontend, just documentation

• Hono app with error unwrapping for debugging and CORS support
• Routes: / (API docs), POST /api/like (record like), GET /api/likes/:website (get count), GET /api/likes (all data)
• Accepts JSON payloads with website and optional pageUrl
• Returns updated like counts for real-time UI updates

# Run/test the application locally
deno run --allow-net --allow-read index.ts

# Lint code
deno lint

# Format code  
deno fmt

# Type checking
deno check index.ts

When modifying the database schema, increment the table name (e.g., website_likes_v1 → website_likes_v2) rather than using ALTER TABLE operations.

The API is designed for cross-origin requests. Example usage from any website:

fetch("https://your-val-url.val.run/api/like", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    website: "mysite.com",
    pageUrl: window.location.pathname,
  }),
})
  .then((res) => res.json())
  .then((data) => console.log("New like count:", data.likeCount));

Uses Val Town utility functions for proper file serving:

import {
  readFile,
  serveFile,
} from "https://esm.town/v/std/utils@85-main/index.ts";

Include this pattern in Hono apps for better error visibility:

app.onError((err, c) => {
  throw err;
});

The API includes CORS headers to allow requests from any origin:

app.use(
  "*",
  cors({
    origin: "*",
    allowMethods: ["GET", "POST", "OPTIONS"],
    allowHeaders: ["Content-Type"],
  }),
);

• TypeScript: Configured with relaxed settings (noImplicitAny: false, strict: false)
• Imports: Uses https://esm.sh for npm packages and https://esm.town/v/ for Val Town utilities
• Styling: TailwindCSS via CDN script tag
• Error Debugging: Includes <script src="https://esm.town/v/std/catch"></script> for client-side error capture