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

FFXIV Completion Tracker (v0) - A lightweight web application for Final Fantasy XIV players to track completion of dungeons, trials, raids, and other instances.

deno lint

deno check main.tsx

deno run --allow-net --allow-env main.tsx

deno run --allow-net --allow-env --watch main.tsx

• Base URL: https://xivapi.com/instancecontent
• Pagination: 100 results per page, 7 total pages (671 instances)
• Required columns: ID,Name,ContentType.Name,ContentFinderCondition.Name,UnlockQuest.Name

https://xivapi.com/instancecontent?columns=ID,Name,ContentType.Name,ContentFinderCondition.Name,UnlockQuest.Name&page=1

• Name: Instance name
• ContentType.Name: Content type (e.g., "Dungeons", "Trials")
• ContentFinderCondition.Name: Duty finder name
• UnlockQuest.Name: Unlock quest (mostly null)

// Loop through all pages (1-7)
for (let page = 1; page <= 7; page++) {
  const response = await fetch(`https://xivapi.com/instancecontent?columns=ID,Name,ContentType.Name,ContentFinderCondition.Name,UnlockQuest.Name&page=${page}`);
}

• Fetches all 7 pages from XIVAPI
• Caches response for 24 hours
• Returns CORS-enabled JSON
• Groups by expansion/content type

• HTML/CSS/Vanilla JS
• Fetches from Val Town endpoint
• localStorage for user progress
• Search/filter functionality

• Val Town: Backend function
• Static hosting: Frontend (Netlify, Vercel, GitHub Pages)