\n \n \n\n","label",[18],"pulls","branches","forks","envVars",{"_171":26,"_173":26},"connections",{"_171":26,"_172":26},"count","unfilledCount","emptyCount",{"_33":409,"_13":408,"_67":402,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":410,"_39":26,"_69":393,"_160":-5,"_70":24,"_162":-5,"_210":411,"_17":412},{"_33":400,"_13":341,"_67":401,"_43":402,"_35":36,"_157":216,"_158":151,"_37":403,"_39":26,"_69":404,"_160":405,"_70":24,"_162":14,"_210":406,"_17":407},{"_33":396,"_13":290,"_67":285,"_43":-5,"_35":36,"_157":40,"_158":151,"_37":397,"_39":26,"_69":393,"_160":-5,"_70":24,"_162":-5,"_210":398,"_17":399},{"_33":391,"_13":348,"_67":343,"_43":285,"_35":36,"_157":40,"_158":151,"_37":392,"_39":26,"_69":393,"_160":-5,"_70":24,"_162":-5,"_210":394,"_17":395},{"_33":384,"_13":385,"_67":386,"_43":343,"_35":36,"_157":216,"_158":151,"_37":387,"_39":40,"_69":208,"_160":388,"_70":24,"_162":-5,"_210":389,"_17":390},{"_33":377,"_13":378,"_67":379,"_43":343,"_35":36,"_157":231,"_158":151,"_37":380,"_39":216,"_69":208,"_160":381,"_70":24,"_162":-5,"_210":382,"_17":383},{"_33":370,"_13":371,"_67":372,"_43":343,"_35":36,"_157":40,"_158":151,"_37":373,"_39":26,"_69":208,"_160":374,"_70":24,"_162":-5,"_210":375,"_17":376},{"_33":363,"_13":364,"_67":365,"_43":343,"_35":36,"_157":40,"_158":151,"_37":366,"_39":26,"_69":208,"_160":367,"_70":24,"_162":-5,"_210":368,"_17":369},{"_33":356,"_13":357,"_67":358,"_43":343,"_35":36,"_157":40,"_158":151,"_37":359,"_39":26,"_69":208,"_160":360,"_70":24,"_162":-5,"_210":361,"_17":362},{"_33":349,"_13":350,"_67":351,"_43":343,"_35":36,"_157":40,"_158":151,"_37":352,"_39":26,"_69":208,"_160":353,"_70":24,"_162":-5,"_210":354,"_17":355},{"_33":340,"_13":341,"_67":342,"_43":343,"_35":36,"_157":40,"_158":151,"_37":344,"_39":26,"_69":208,"_160":345,"_70":24,"_162":-5,"_210":346,"_17":347},{"_33":333,"_13":334,"_67":335,"_43":285,"_35":36,"_157":40,"_158":151,"_37":336,"_39":26,"_69":208,"_160":337,"_70":24,"_162":-5,"_210":338,"_17":339},{"_33":326,"_13":327,"_67":328,"_43":285,"_35":36,"_157":40,"_158":151,"_37":329,"_39":26,"_69":208,"_160":330,"_70":24,"_162":-5,"_210":331,"_17":332},{"_33":319,"_13":320,"_67":321,"_43":285,"_35":36,"_157":231,"_158":151,"_37":322,"_39":216,"_69":208,"_160":323,"_70":24,"_162":-5,"_210":324,"_17":325},{"_33":312,"_13":313,"_67":314,"_43":285,"_35":36,"_157":76,"_158":151,"_37":315,"_39":40,"_69":208,"_160":316,"_70":24,"_162":-5,"_210":317,"_17":318},{"_33":305,"_13":306,"_67":307,"_43":285,"_35":36,"_157":40,"_158":151,"_37":308,"_39":26,"_69":208,"_160":309,"_70":24,"_162":-5,"_210":310,"_17":311},{"_33":298,"_13":299,"_67":300,"_43":285,"_35":36,"_157":40,"_158":151,"_37":301,"_39":26,"_69":208,"_160":302,"_70":24,"_162":-5,"_210":303,"_17":304},{"_33":291,"_13":292,"_67":293,"_43":285,"_35":36,"_157":40,"_158":151,"_37":294,"_39":26,"_69":208,"_160":295,"_70":24,"_162":-5,"_210":296,"_17":297},{"_33":282,"_13":283,"_67":284,"_43":285,"_35":36,"_157":76,"_158":151,"_37":286,"_39":40,"_69":208,"_160":287,"_70":24,"_162":-5,"_210":288,"_17":289},{"_33":275,"_13":276,"_67":277,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":278,"_39":26,"_69":21,"_160":279,"_70":24,"_162":-5,"_210":280,"_17":281},{"_33":268,"_13":269,"_67":270,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":271,"_39":26,"_69":21,"_160":272,"_70":24,"_162":-5,"_210":273,"_17":274},{"_33":261,"_13":262,"_67":263,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":264,"_39":26,"_69":21,"_160":265,"_70":24,"_162":-5,"_210":266,"_17":267},{"_33":254,"_13":255,"_67":256,"_43":-5,"_35":36,"_157":40,"_158":151,"_37":257,"_39":26,"_69":21,"_160":258,"_70":24,"_162":-5,"_210":259,"_17":260},{"_33":247,"_13":248,"_67":249,"_43":-5,"_35":36,"_157":76,"_158":151,"_37":250,"_39":40,"_69":208,"_160":251,"_70":24,"_162":-5,"_210":252,"_17":253},{"_33":240,"_13":241,"_67":242,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":243,"_39":26,"_69":21,"_160":244,"_70":24,"_162":-5,"_210":245,"_17":246},{"_33":156,"_13":18,"_67":68,"_43":-5,"_35":36,"_157":76,"_158":151,"_37":237,"_39":40,"_69":21,"_160":161,"_70":24,"_162":-5,"_210":238,"_17":239},{"_33":228,"_13":229,"_67":230,"_43":-5,"_35":36,"_157":231,"_158":151,"_37":232,"_39":233,"_69":208,"_160":234,"_70":24,"_162":-5,"_210":235,"_17":236},{"_33":221,"_13":222,"_67":223,"_43":-5,"_35":36,"_157":76,"_158":151,"_37":224,"_39":40,"_69":208,"_160":225,"_70":24,"_162":-5,"_210":226,"_17":227},{"_33":213,"_13":214,"_67":215,"_43":-5,"_35":36,"_157":216,"_158":151,"_37":217,"_39":40,"_69":21,"_160":218,"_70":24,"_162":-5,"_210":219,"_17":220},{"_33":204,"_13":205,"_67":206,"_43":-5,"_35":36,"_157":119,"_158":151,"_37":207,"_39":76,"_69":208,"_160":209,"_70":24,"_162":-5,"_210":211,"_17":212},"1823ee18-33fb-11f1-98c3-42b51c65c3df","types.ts","019cce74-2a39-76a3-acb5-c02ca89e918d",["D",1775728895991],"script","export type NotificationTypes = \"success\" | \"info\" | \"warning\";\n\nexport type Language = \"en\" | \"nl\" | \"tr\";\n\nexport interface PhoneticInfo {\n ipa: string;\n approximate: string;\n}\n\nexport interface ExampleSentence {\n text: string;\n translation?: string;\n}\n\nexport interface WordMeaning {\n lang: Language;\n word: string;\n partOfSpeech: string;\n gender?: string;\n article?: string;\n phonetic: PhoneticInfo;\n definition: string;\n examples: ExampleSentence[];\n}\n\nexport interface CultureShelfItem {\n type: \"quote\" | \"note\" | \"link\";\n title: string;\n content: string;\n source?: string;\n url?: string;\n lang: Language;\n}\n\nexport interface WordOfTheWeek {\n id: string;\n weekOf: string;\n primary: WordMeaning;\n translations: WordMeaning[];\n cultureShelf: CultureShelfItem[];\n}\n","children",[],[205],"ba4ddb94-1b15-11f1-9492-42dde27851f2","style.css","019cce74-2a39-76a3-acb5-bee07ac82ceb",2,["D",1772991555869],"/* Utility classes */\n\n.hide-scrollbar {\n -ms-overflow-style: none;\n scrollbar-width: none;\n}\n.hide-scrollbar::-webkit-scrollbar {\n display: none;\n}\n\n.line-clamp-3 {\n display: -webkit-box;\n -webkit-line-clamp: 3;\n -webkit-box-orient: vertical;\n overflow: hidden;\n}\n\n/* Notification animations */\n\n.notification {\n animation: slideIn 0.3s ease-out;\n}\n\n.slide-out {\n animation: slideOut 0.3s ease-in forwards;\n}\n\n@keyframes slideIn {\n from {\n transform: translateX(100%);\n opacity: 0;\n }\n to {\n transform: translateX(0);\n opacity: 1;\n }\n}\n\n@keyframes slideOut {\n from {\n transform: translateX(0);\n opacity: 1;\n }\n to {\n transform: translateX(100%);\n opacity: 0;\n }\n}\n",[],[214],"1b2e4d78-1c7d-11f1-a323-42dde27851f2","lang.ts","ba4db3b2-1b15-11f1-9492-42dde27851f2",["D",1773145907744],"import type { Language } from \"./types.ts\";\n\nexport const LANG_LABELS: Record = {\n en: \"English\",\n nl: \"Nederlands\",\n tr: \"Türkçe\",\n};\n\nexport const LANG_BADGE_COLORS: Record = {\n en: \"bg-blue-100 text-blue-700\",\n nl: \"bg-orange-100 text-orange-700\",\n tr: \"bg-red-100 text-red-700\",\n};\n\nexport const LANG_BG: Record = {\n en: \"bg-blue-500\",\n nl: \"bg-orange-500\",\n tr: \"bg-red-500\",\n};\n\nexport const LANG_BORDER: Record = {\n en: \"border-blue-400\",\n nl: \"border-orange-400\",\n tr: \"border-red-400\",\n};\n\nexport const LANG_TEXT: Record = {\n en: \"text-blue-700\",\n nl: \"text-orange-700\",\n tr: \"text-red-700\",\n};\n\nexport const LANG_BG_LIGHT: Record = {\n en: \"bg-blue-50\",\n nl: \"bg-orange-50\",\n tr: \"bg-red-50\",\n};\n",[],[222],"d90514f0-1efb-11f1-8a97-42dde27851f2","index.tsx","019cce74-2a39-76a3-acb5-b9adada3fea0",5,["D",1773420245163],4,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport { useEffect, useRef, useState } from \"https://esm.sh/react@18.2.0\";\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { Button } from \"./components/Button.tsx\";\nimport { Notification } from \"./components/Notification.tsx\";\nimport { Container } from \"./components/ui/index.ts\";\nimport { CultureShelf } from \"./components/CultureShelf.tsx\";\nimport { wordOfTheWeek } from \"./data.ts\";\nimport { LANG_BADGE_COLORS, LANG_BG_LIGHT, LANG_BORDER, LANG_LABELS, LANG_TEXT } from \"./lang.ts\";\nimport type { Language, WordMeaning } from \"./types.ts\";\n\nconst LANG_FLAGS: Record = {\n en: \"\\u{1F1EC}\\u{1F1E7}\",\n nl: \"\\u{1F1F3}\\u{1F1F1}\",\n tr: \"\\u{1F1F9}\\u{1F1F7}\",\n};\n\nfunction FitText({ text, className }: { text: string; className?: string }) {\n const ref = useRef(null);\n\n useEffect(() => {\n const el = ref.current;\n if (!el) return;\n el.style.fontSize = \"\";\n let size = parseFloat(getComputedStyle(el).fontSize);\n while (el.scrollWidth > el.clientWidth && size > 16) {\n size -= 1;\n el.style.fontSize = `${size}px`;\n }\n }, [text]);\n\n return

{text}

;\n}\n\nfunction LangCard({\n meaning,\n isActive,\n onClick,\n}: {\n meaning: WordMeaning;\n isActive: boolean;\n onClick: () => void;\n}) {\n const borderClass = LANG_BORDER[meaning.lang];\n const badgeClass = LANG_BADGE_COLORS[meaning.lang];\n const textClass = LANG_TEXT[meaning.lang];\n const bgLightClass = LANG_BG_LIGHT[meaning.lang];\n\n return (\n \n {/* Active content */}\n \n \n {LANG_LABELS[meaning.lang]}\n \n \n

\n \n {meaning.phonetic.ipa}\n \n

\n {meaning.phonetic.approximate}\n

\n \n {meaning.partOfSpeech}\n \n \n {/* Inactive content */}\n \n {LANG_FLAGS[meaning.lang]}\n {LANG_LABELS[meaning.lang]}\n {meaning.word}\n \n \n );\n}\n\nfunction MobileTabBar({\n meanings,\n activeLang,\n onSelect,\n}: {\n meanings: WordMeaning[];\n activeLang: Language;\n onSelect: (lang: Language) => void;\n}) {\n return (\n

\n {meanings.map((m) => {\n const isActive = m.lang === activeLang;\n return (\n onSelect(m.lang)}\n className={[\n \"flex-1 py-3 text-center text-sm font-medium border-b-2 transition-colors\",\n isActive\n ? `${LANG_BORDER[m.lang]} ${LANG_TEXT[m.lang]}`\n : \"text-gray-400 border-transparent\",\n ].join(\" \")}\n >\n {LANG_FLAGS[m.lang]} {m.lang.toUpperCase()}\n \n );\n })}\n

\n );\n}\n\nfunction MobileCard({ meaning }: { meaning: WordMeaning }) {\n const borderClass = LANG_BORDER[meaning.lang];\n const badgeClass = LANG_BADGE_COLORS[meaning.lang];\n\n return (\n

\n \n {LANG_LABELS[meaning.lang]}\n \n \n

\n {meaning.phonetic.ipa}\n

{meaning.phonetic.approximate}

\n \n {meaning.partOfSpeech}\n \n

\n );\n}\n\nfunction MeaningPanel({ meaning }: { meaning: WordMeaning }) {\n const badgeClass = LANG_BADGE_COLORS[meaning.lang];\n\n return (\n

\n \n {meaning.partOfSpeech}\n \n {meaning.article && (\n \n {meaning.article}\n \n )}\n {meaning.gender && (\n ({meaning.gender})\n )}\n

{meaning.definition}

\n {meaning.examples.map((ex, i) => (\n \n

{ex.text}

\n {ex.translation && (\n

\n {ex.translation}\n

\n )}\n \n ))}\n

\n );\n}\n\nfunction App() {\n const [activeLang, setActiveLang] = useState(wordOfTheWeek.primary.lang);\n const [notification, setNotification] = useState<{\n message: string;\n type: \"success\" | \"info\" | \"warning\";\n } | null>(null);\n\n const allMeanings: WordMeaning[] = [\n wordOfTheWeek.primary,\n ...wordOfTheWeek.translations,\n ];\n const activeMeaning = allMeanings.find((m) => m.lang === activeLang)!;\n const filteredCultureItems = wordOfTheWeek.cultureShelf.filter(\n (item) => item.lang === activeLang,\n );\n\n return (\n \n {/* Mobile: tab bar + full-width card */}\n

\n \n \n

\n\n {/* Desktop: side-by-side cards */}\n

\n {allMeanings.map((m) => (\n setActiveLang(m.lang)}\n />\n ))}\n

\n\n

\n \n

\n\n {/* Culture Shelf */}\n {filteredCultureItems.length > 0 && (\n \n )}\n\n {/* Bottom bar */}\n

\n \n \n \n setNotification({ message: \"Share link copied!\", type: \"success\" })\n }\n variant=\"primary\"\n >\n Share\n \n

\n\n {notification && (\n setNotification(null)}\n />\n )}\n \n );\n}\n\nconst root = createRoot(document.getElementById(\"root\")!);\nroot.render();\n",[],[229],["D",1773145907744],[],[18],"ba4dad9a-1b15-11f1-9492-42dde27851f2","deno.json","ba4dae1c-1b15-11f1-9492-42dde27851f2",["D",1772991555869],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[241],"1b2e07a0-1c7d-11f1-a323-42dde27851f2","data.ts","ba4d9274-1b15-11f1-9492-42dde27851f2",["D",1773145907744],"import type { WordOfTheWeek } from \"./types.ts\";\n\nexport const wordOfTheWeek: WordOfTheWeek = {\n id: \"wotw-2026-10\",\n weekOf: \"2026-03-08\",\n primary: {\n lang: \"en\",\n word: \"Serendipity\",\n partOfSpeech: \"noun\",\n phonetic: {\n ipa: \"/ˌsɛr.ənˈdɪp.ɪ.ti/\",\n approximate: \"ser-uhn-DIP-ih-tee\",\n },\n definition:\n \"The occurrence of finding pleasant or valuable things by chance, without actively searching for them.\",\n examples: [\n {\n text: \"It was pure serendipity that we met at the bookshop that rainy afternoon.\",\n },\n {\n text: \"Many scientific discoveries have been made through serendipity rather than deliberate research.\",\n },\n ],\n },\n translations: [\n {\n lang: \"nl\",\n word: \"Serendipiteit\",\n partOfSpeech: \"zelfstandig naamwoord\",\n gender: \"feminine\",\n article: \"de\",\n phonetic: {\n ipa: \"/ˌseː.rɛn.diˈpi.tɛit/\",\n approximate: \"say-ren-dee-pee-TAIT\",\n },\n definition:\n \"Het onverwacht ontdekken van iets waardevols of aangenaams terwijl je naar iets anders op zoek bent.\",\n examples: [\n {\n text: \"De ontdekking van penicilline was een geval van serendipiteit.\",\n translation:\n \"The discovery of penicillin was a case of serendipity.\",\n },\n {\n text: \"Soms leidt serendipiteit tot de mooiste vriendschappen.\",\n translation:\n \"Sometimes serendipity leads to the most beautiful friendships.\",\n },\n ],\n },\n {\n lang: \"tr\",\n word: \"Tesadüfi keşif\",\n partOfSpeech: \"isim\",\n phonetic: {\n ipa: \"/te.sæ.dyˈfi keˈʃif/\",\n approximate: \"teh-sa-dü-FEE keh-SHEEF\",\n },\n definition:\n \"Bir şeyi ararken, beklenmedik bir şekilde değerli veya hoş başka bir şey bulma durumu.\",\n examples: [\n {\n text: \"Hayatımdaki en güzel anılar tesadüfi keşiflerle dolu.\",\n translation:\n \"The most beautiful memories in my life are full of serendipitous discoveries.\",\n },\n {\n text: \"Bu restoran tamamen bir tesadüfi keşifti.\",\n translation:\n \"This restaurant was a complete serendipitous discovery.\",\n },\n ],\n },\n ],\n cultureShelf: [\n {\n type: \"quote\",\n title: \"Horace Walpole\",\n content:\n \"Serendipity — the faculty of making happy and unexpected discoveries by accident.\",\n source: \"Letter to Horace Mann, 1754\",\n lang: \"en\",\n },\n {\n type: \"note\",\n title: \"Etymology\",\n content:\n \"Coined by Horace Walpole in 1754, inspired by the Persian fairy tale 'The Three Princes of Serendip' (Sri Lanka), whose heroes were always making discoveries by accidents and sagacity.\",\n lang: \"en\",\n },\n {\n type: \"note\",\n title: \"Nederlandse context\",\n content:\n \"Het woord 'serendipiteit' wordt in het Nederlands steeds vaker gebruikt, maar 'toevalstreffer' blijft het meer gangbare alternatief in dagelijks taalgebruik.\",\n lang: \"nl\",\n },\n {\n type: \"note\",\n title: \"Türkçe bağlam\",\n content:\n \"Türkçede doğrudan bir karşılığı olmayan bu kavram, genellikle 'şans eseri buluş' veya 'tesadüfi keşif' olarak ifade edilir.\",\n lang: \"tr\",\n },\n ],\n};\n",[],[248],"ad51947e-1b12-11f1-9d9e-42dde27851f2","README.md","019cce74-2a39-76a3-acb5-b0f0768ca2ef",["D",1772990244836],"The starter template is designed for static serving (Twind shim + esm.sh imports, no build step), so it maps to Val Town pretty directly. Here's the approach:\n\n**1. Create an HTTP val that serves the HTML**\n\n```ts\n// your-app.ts (HTTP val)\nexport default async function(req: Request): Promise {\n const url = new URL(req.url);\n \n // Serve component files from companion vals\n if (url.pathname === \"/style.css\") {\n return new Response(styleCSS, { headers: { \"content-type\": \"text/css\" } });\n }\n if (url.pathname === \"/index.tsx\") {\n return new Response(indexTSX, { headers: { \"content-type\": \"application/typescript\" } });\n }\n \n return new Response(indexHTML, { headers: { \"content-type\": \"text/html\" } });\n}\n```\n\n**2. The challenge: multi-file structure**\n\nVal Town vals are single files, so you have two options:\n\n- **Inline everything** — Collapse the components into one or two vals. This is simplest but loses the nice file structure.\n- **Use Val Town's module imports** — Publish each component as its own val, then change the import paths in `index.tsx` to `https://esm.town/v/yourname/Button` etc.\n\n**3. Practical steps**\n\n1. Create a new HTTP val\n2. Paste the `index.html` content as a template string, updating the `\n \n`;\n\nexport default () => new Response(html, { headers: { \"content-type\": \"text/html\" } });\n```\n\nThe esm.sh React imports and Twind CDN shim will work as-is in Val Town since they're already URL-based. The main adaptation is flattening the file structure to fit Val Town's single-file-per-val model.\n",[],[255],"ba4d59c6-1b15-11f1-9492-42dde27851f2","CLAUDE.md","ba4d5a52-1b15-11f1-9492-42dde27851f2",["D",1772991555869],"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\nThis is a **Val Town project** — a React component library starter template that runs on the Val Town platform (serverless Deno environment, not Node.js). It uses no build step: Twind shim for CSS-in-JS and esm.sh for imports, served statically.\n\n## Runtime & Platform\n\n- **Runtime:** Deno (Val Town serverless), configured via `deno.json`\n- **Imports:** All dependencies come from `https://esm.sh` (works in both browser and server)\n- **React:** Pinned to 18.2.0 — all React dependencies and sub-dependencies must use `?deps=react@18.2.0,react-dom@18.2.0`\n- **JSX:** Every TSX file must start with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- **Styling:** TailwindCSS via Twind shim (`` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n \n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[],[269],"ba4cdae6-1b15-11f1-9492-42dde27851f2",".vtignore","ba4cdba4-1b15-11f1-9492-42dde27851f2",["D",1772991555869],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[],[276],"1b2df594-1c7d-11f1-a323-42dde27851f2","TranslationStrip.tsx","ba4d850e-1b15-11f1-9492-42dde27851f2","019cce74-2a39-76a3-acb5-aeccea3cb030",["D",1773145907744],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { Language, WordMeaning } from \"../types.ts\";\nimport { LANG_BADGE_COLORS, LANG_BORDER, LANG_LABELS } from \"../lang.ts\";\n\ninterface TranslationStripProps {\n translations: WordMeaning[];\n onSelect?: (lang: Language) => void;\n}\n\nexport function TranslationStrip({ translations, onSelect }: TranslationStripProps) {\n return (\n

\n {translations.map((t) => {\n const badgeClass = LANG_BADGE_COLORS[t.lang];\n const borderClass = LANG_BORDER[t.lang];\n\n return (\n onSelect?.(t.lang)}\n className={`flex-1 min-w-[140px] bg-white rounded-lg border-2 ${borderClass} px-5 py-4 ${onSelect ? \"cursor-pointer hover:shadow-md transition-shadow\" : \"\"}`}\n >\n \n {LANG_LABELS[t.lang]}\n \n

{t.word}

{t.phonetic.ipa}

\n {t.article && (\n \n {t.article}\n \n )}\n

\n );\n })}\n \n );\n}\n",[],[290,283],"components","ad5186e6-1b12-11f1-9d9e-42dde27851f2","Notification.tsx","019cce74-2a39-76a3-acb5-a9180821df43",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport { useEffect, useRef, useState } from \"https://esm.sh/react@18.2.0\";\nimport { getAsset, type NotificationTypes } from \"./Icons.tsx\";\n\ninterface NotificationProps {\n message: string;\n type: NotificationTypes;\n onClose: () => void;\n}\n\nexport function Notification({ message, type, onClose }: NotificationProps) {\n const [isClosing, setIsClosing] = useState(false);\n const notificationRef = useRef(null);\n\n const handleClose = () => {\n setIsClosing(true);\n setTimeout(() => {\n onClose();\n }, 300);\n };\n\n const handleKeyDown = (event: React.KeyboardEvent) => {\n if (event.key === \"Enter\" || event.key === \" \") {\n event.preventDefault();\n handleClose();\n }\n };\n\n useEffect(() => {\n const timer = setTimeout(handleClose, 3000);\n\n return () => clearTimeout(timer);\n }, []);\n\n const icon = getAsset(type);\n\n const notificationColors = {\n success: \"bg-[#ecfdf3] border border-[#bffcd9] text-[#008a2e]\",\n info: \"bg-[#f0f8ff] border border-[#dde7fd] text-[#0973dc]\",\n warning: \"bg-[#fffcf0] border border-[#fbeeb1] text-[#dc7609]\",\n };\n\n return (\n \n

\n {icon}\n {message}\n

\n \n );\n}\n",[],[290,292],"ad5183da-1b12-11f1-9d9e-42dde27851f2","Link.tsx","019cce74-2a39-76a3-acb5-a754dcb1094d",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0?dev */\n\nexport const Link = ({\n children,\n href,\n className = \"\",\n}: {\n children: React.ReactNode;\n href: string;\n className?: string;\n}) => (\n \n {children}\n \n);\n",[],[290,299],"ad517a3e-1b12-11f1-9d9e-42dde27851f2","Icons.tsx","019cce74-2a39-76a3-acb5-a3f37b3fb0b5",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { NotificationTypes } from \"../types.ts\";\n\nconst Icon = ({\n children,\n title,\n className,\n}: {\n children: React.ReactNode;\n title: string;\n className?: string;\n}) => (\n \n {title}\n {children}\n \n);\n\nexport const getAsset = (type: NotificationTypes): JSX.Element | null => {\n switch (type) {\n case \"success\":\n return SuccessIcon;\n\n case \"info\":\n return InfoIcon;\n\n case \"warning\":\n return WarningIcon;\n\n default:\n return null;\n }\n};\n\nconst SuccessIcon = (\n \n \n \n \n);\n\nconst WarningIcon = (\n \n \n \n \n \n);\n\nconst InfoIcon = (\n \n \n \n \n \n);\n",[],[290,306],"1b2de07c-1c7d-11f1-a323-42dde27851f2","HeroWord.tsx","ba4d778a-1b15-11f1-9492-42dde27851f2",["D",1773145907744],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { WordMeaning } from \"../types.ts\";\nimport { LANG_BADGE_COLORS, LANG_LABELS } from \"../lang.ts\";\n\ninterface HeroWordProps {\n meaning: WordMeaning;\n onSpeakerClick: () => void;\n className?: string;\n}\n\nexport function HeroWord({ meaning, onSpeakerClick, className = \"\" }: HeroWordProps) {\n const badgeClass = LANG_BADGE_COLORS[meaning.lang];\n\n return (\n

\n \n {LANG_LABELS[meaning.lang]}\n \n

{meaning.word}

\n \n {meaning.phonetic.ipa}\n \n \n \n \n \n \n \n \n

\n {meaning.phonetic.approximate}\n

\n \n {meaning.partOfSpeech}\n \n

\n );\n}\n",[],[290,313],"d904e35e-1efb-11f1-8a97-42dde27851f2","CultureShelf.tsx","ba4d6d80-1b15-11f1-9492-42dde27851f2",["D",1773420245163],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { CultureShelfItem } from \"../types.ts\";\nimport { LANG_BORDER, LANG_BADGE_COLORS, LANG_LABELS } from \"../lang.ts\";\n\ninterface CultureShelfProps {\n items: CultureShelfItem[];\n}\n\nconst typeIcons: Record = {\n quote: \"\\u201C\",\n note: \"\\uD83D\\uDCDD\",\n link: \"\\uD83D\\uDD17\",\n};\n\nexport function CultureShelf({ items }: CultureShelfProps) {\n return (\n

\n {items.map((item, i) => {\n const borderClass = LANG_BORDER[item.lang];\n const badgeClass = LANG_BADGE_COLORS[item.lang];\n\n return (\n \n

\n {typeIcons[item.type]}\n \n {LANG_LABELS[item.lang]}\n \n

{item.title}

{item.content}

\n {item.source && (\n

\n — {item.source}\n

\n )}\n

\n );\n })}\n \n );\n}\n",[],[290,320],"ad5175c0-1b12-11f1-9d9e-42dde27851f2","Card.tsx","019cce74-2a39-76a3-acb5-9d795139433f",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface CardProps {\n children: React.ReactNode;\n className?: string;\n}\n\nexport function CardHeader({ children, className = \"\" }: CardProps) {\n return

{children}

;\n}\n\nexport function Card({ children, className = \"\" }: CardProps) {\n return (\n \n {children}\n \n );\n}\n",[],[290,327],"ad516ac6-1b12-11f1-9d9e-42dde27851f2","Button.tsx","019cce74-2a39-76a3-acb5-9a8234e8b154",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface ButtonProps {\n children: React.ReactNode;\n onClick: () => void;\n variant?:\n | \"primary\"\n | \"secondary\"\n | \"info\"\n | \"warning\"\n | \"purple\"\n | \"danger\"\n | \"neutral\";\n size?: \"sm\" | \"md\" | \"lg\";\n className?: string;\n type?: \"button\" | \"submit\" | \"reset\";\n title?: string;\n disabled?: boolean;\n}\n\nexport function Button({\n children,\n onClick,\n variant = \"primary\",\n size = \"md\",\n className = \"\",\n type = \"button\",\n title,\n disabled = false,\n}: ButtonProps) {\n const baseClasses =\n \"border-2 border-black text-black font-semibold rounded-lg transition-colors\";\n\n const variantClasses = {\n primary: \"bg-green(300 hover:400)\",\n secondary: \"bg-gray(100 hover:200)\",\n info: \"bg-blue(300 hover:400)\",\n warning: \"bg-yellow(300 hover:400)\",\n purple: \"bg-purple(300 hover:400)\",\n danger: \"bg-red(300 hover:400)\",\n neutral: \"\",\n };\n\n const sizeClasses = {\n sm: \"py-2 px-4 text-sm\",\n md: \"py-3 px-6\",\n lg: \"py-3 px-6 text-lg\",\n };\n\n return (\n \n {children}\n \n );\n}\n",[],[290,334],"ad516512-1b12-11f1-9d9e-42dde27851f2","index.ts","019cce74-2a39-76a3-acb5-90bb214f42c1","019cce74-2a39-76a3-acb5-96695935014e",["D",1772990244836],"export { Input } from \"./Input.tsx\";\nexport { Table } from \"./Table.tsx\";\nexport type { Column } from \"./Table.tsx\";\nexport { Tabs } from \"./Tabs.tsx\";\nexport { Label } from \"./Label.tsx\";\nexport { Container } from \"./Container.tsx\";\nexport { Badge } from \"./Badge.tsx\";\n",[],[290,348,341],"ui","ad515db0-1b12-11f1-9d9e-42dde27851f2","Tabs.tsx","019cce74-2a39-76a3-acb5-8c9c989511fc",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface Tab {\n id: string;\n label: string;\n}\n\ninterface TabsProps {\n tabs: Tab[];\n activeTab: string;\n onTabChange: (id: string) => void;\n variant?: \"underline\" | \"pill\";\n className?: string;\n}\n\nexport function Tabs({\n tabs,\n activeTab,\n onTabChange,\n variant = \"underline\",\n className = \"\",\n}: TabsProps) {\n if (variant === \"pill\") {\n return (\n

\n {tabs.map((t) => (\n onTabChange(t.id)}\n className={`px-3 py-1 text-sm rounded ${\n activeTab === t.id\n ? \"bg-gray-800 text-white\"\n : \"bg-gray-100 text-gray-600 hover:bg-gray-200\"\n }`}\n >\n {t.label}\n \n ))}\n

\n );\n }\n\n return (\n

\n {tabs.map((t) => (\n onTabChange(t.id)}\n className={`px-4 py-2 text-sm font-medium border-b-2 -mb-px ${\n activeTab === t.id\n ? \"border-blue-600 text-blue-600\"\n : \"border-transparent text-gray-500 hover:text-gray-700\"\n }`}\n >\n {t.label}\n \n ))}\n

\n );\n}\n",[],[290,348,350],"ad5155ea-1b12-11f1-9d9e-42dde27851f2","Table.tsx","019cce74-2a39-76a3-acb5-89af702a3ec4",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nexport interface Column {\n key: string;\n header: string;\n render?: (row: T) => React.ReactNode;\n className?: string;\n}\n\ninterface TableProps {\n columns: Column[];\n data: T[];\n rowKey: (row: T) => string | number;\n emptyMessage?: string;\n loading?: boolean;\n loadingMessage?: string;\n}\n\nexport function Table({\n columns,\n data,\n rowKey,\n emptyMessage = \"No data.\",\n loading = false,\n loadingMessage = \"Loading...\",\n}: TableProps) {\n if (loading) return

{loadingMessage}

;\n if (data.length === 0) return

{emptyMessage}

;\n\n return (\n

\n \n \n \n {columns.map((col) => (\n \n ))}\n \n \n \n {data.map((row) => (\n \n {columns.map((col) => (\n \n ))}\n \n ))}\n \n

\n {col.header}\n
\n {col.render ? col.render(row) : (row as any)[col.key]}\n

\n );\n}\n",[],[290,348,357],"ad51520c-1b12-11f1-9d9e-42dde27851f2","Label.tsx","019cce74-2a39-76a3-acb5-87a4e4e8dcc5",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface LabelProps {\n children: React.ReactNode;\n htmlFor?: string;\n hint?: string;\n className?: string;\n}\n\nexport function Label({ children, htmlFor, hint, className = \"\" }: LabelProps) {\n return (\n <>\n \n {children}\n \n {hint &&

{hint}

}\n \n );\n}\n",[],[290,348,364],"ad514ae6-1b12-11f1-9d9e-42dde27851f2","Input.tsx","019cce74-2a39-76a3-acb5-821a1dd745a2",["D",1772990244836],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface InputProps {\n type?: \"text\" | \"password\" | \"number\";\n value: string;\n onChange: (value: string) => void;\n onKeyDown?: (e: React.KeyboardEvent) => void;\n placeholder?: string;\n size?: \"sm\" | \"md\";\n autoFocus?: boolean;\n step?: string;\n list?: string;\n className?: string;\n disabled?: boolean;\n}\n\nconst sizeClasses = {\n sm: \"py-1 px-2 text-sm\",\n md: \"py-2 px-3\",\n};\n\nexport function Input({\n type = \"text\",\n value,\n onChange,\n onKeyDown,\n placeholder,\n size = \"md\",\n autoFocus,\n step,\n list,\n className = \"\",\n disabled,\n}: InputProps) {\n const baseClasses =\n \"border border-gray-300 rounded focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent\";\n\n return (\n onChange(e.target.value)}\n onKeyDown={onKeyDown}\n placeholder={placeholder}\n className={`${baseClasses} ${sizeClasses[size]} ${className}`}\n autoFocus={autoFocus}\n step={step}\n list={list}\n disabled={disabled}\n />\n );\n}\n",[],[290,348,371],"d9050ca8-1efb-11f1-8a97-42dde27851f2","Container.tsx","019cce74-2a39-76a3-acb5-7c54d0cc5265",["D",1773420245163],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface ContainerProps {\n children: React.ReactNode;\n size?: \"md\" | \"lg\";\n className?: string;\n}\n\nconst sizeClasses = {\n md: \"max-w-2xl mx-auto p-4 sm:p-8\",\n lg: \"max-w-5xl mx-auto p-4\",\n};\n\nexport function Container({ children, size = \"md\", className = \"\" }: ContainerProps) {\n return (\n

\n {children}\n

\n );\n}\n",[],[290,348,378],"ba4dbcd6-1b15-11f1-9492-42dde27851f2","Badge.tsx","019cce74-2a39-76a3-acb5-782817f69bac",["D",1772991555869],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ntype BadgeColor = \"green\" | \"blue\" | \"gray\" | \"red\" | \"yellow\" | \"purple\" | \"orange\";\n\ninterface BadgeProps {\n children?: React.ReactNode;\n color?: BadgeColor;\n variant?: \"dot\" | \"label\";\n className?: string;\n}\n\nconst dotColorClasses: Record = {\n green: \"bg-green-500\",\n blue: \"bg-blue-500\",\n gray: \"bg-gray-400\",\n red: \"bg-red-500\",\n yellow: \"bg-yellow-500\",\n purple: \"bg-purple-500\",\n orange: \"bg-orange-500\",\n};\n\nconst labelColorClasses: Record = {\n green: \"bg-green-100 text-green-700\",\n blue: \"bg-blue-100 text-blue-700\",\n gray: \"bg-gray-100 text-gray-700\",\n red: \"bg-red-100 text-red-700\",\n yellow: \"bg-yellow-100 text-yellow-700\",\n purple: \"bg-purple-100 text-purple-700\",\n orange: \"bg-orange-100 text-orange-700\",\n};\n\nexport function Badge({\n children,\n color = \"gray\",\n variant = \"dot\",\n className = \"\",\n}: BadgeProps) {\n if (variant === \"dot\") {\n return (\n \n );\n }\n\n return (\n \n {children}\n \n );\n}\n",[],[290,348,385],"ad51694a-1b12-11f1-9d9e-42dde27851f2",["D",1772990244836],"directory",[178,179,180,181,182,183,184],[290,348],"ad519316-1b12-11f1-9d9e-42dde27851f2",["D",1772990244836],[177,185,186,187,188,189,190,191,192],[290],"ba4d4828-1b15-11f1-9492-42dde27851f2","ba4d48be-1b15-11f1-9492-42dde27851f2","019cce88-291d-7570-a18e-51269a7b6a2f",["D",1772991555869],"http","import { Hono } from \"https://esm.sh/hono@4.7.0\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/components/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/style.css\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/index.tsx\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/types.ts\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/lang.ts\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/data.ts\", (c) => serveFile(c.req.path, import.meta.url));\n\n// Serve index.html at root\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/index.html\", import.meta.url);\n return c.html(html);\n});\n\nexport default app.fetch;\n",[],[408,341],"backend","ba4dbb1e-1b15-11f1-9492-42dde27851f2",["D",1772991555869],[175],[408],["D",1772990244836],{"_11":12,"_133":73},{"_11":12,"_128":129,"_72":73,"_30":71,"_130":131,"_132":24},{"_39":119,"_13":16,"_33":36,"_120":86,"_121":-5,"_122":-5,"_123":-5,"_124":-5,"_125":-5,"_126":14,"_127":12},"ctx",{"_52":-5,"_153":450,"_451":452,"_453":454,"_455":24,"_456":24,"_457":24,"_458":151,"_459":-5,"_460":-7,"_461":-7,"_462":26,"_463":24,"_464":24,"_465":-5,"_466":24,"_467":24,"_468":24,"_469":-5},"ENV",{"_421":422,"_423":424,"_425":16,"_426":427,"_428":429,"_430":431,"_432":433,"_434":435,"_436":437,"_438":439,"_440":441,"_442":443,"_444":445,"_446":447,"_448":449},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · index.html