[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_334":335,"_336":337},"routes/_app.x.$handle.$name",{"_100":99,"_32":45,"_108":86,"_27":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_20":-5,"_120":121,"_122":123,"_124":25,"_125":126,"_127":58,"_128":-5,"_129":-5,"_130":131},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":-5,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":58,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":25},"version",20,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","components.tsx","latestPath","fileId","e346ed5a-50c1-448a-8780-0a27726ad45a","name","fileType","script","content","/** @jsxImportSource npm:react */\n/** @jsxImportSourceTypes npm:@types/react */\nimport { JSX } from \"npm:react\";\nimport { clientScript } from \"./client.tsx\";\nimport { styles } from \"./styles.tsx\";\nimport {\n ActiveProjectData,\n ContributorData,\n DocSearchResult,\n EnhancedSearchResult,\n ProjectSearchResult,\n StatsData,\n SubDocResult,\n UserSearchResult,\n EditedValResult,\n NewsletterProjectResult,\n} from \"./types.tsx\";\nimport { formatFullDate, formatRelativeTime } from \"./utils.tsx\";\n\n// Define the Activity Heatmap component\nexport function ActivityHeatmap({ activityData }: { activityData: { date: string; count: number }[] }) {\n // Convert activity data to a map for easier lookup\n const activityMap = new Map(activityData.map(item => [item.date, item.count]));\n\n // Get date range (last 6 months)\n const today = new Date();\n const startDate = new Date(today);\n startDate.setMonth(today.getMonth() - 6);\n\n // Find the end of the current week (Saturday)\n const endOfWeek = new Date(today);\n const daysUntilEndOfWeek = 6 - today.getDay(); // Days until Saturday\n endOfWeek.setDate(today.getDate() + daysUntilEndOfWeek);\n\n // Generate all dates between start and end date\n const dates: Date[] = [];\n const currentDate = new Date(startDate);\n while (currentDate <= endOfWeek) {\n dates.push(new Date(currentDate));\n currentDate.setDate(currentDate.getDate() + 1);\n }\n\n // Find the maximum activity count for color scaling\n const maxCount = Math.max(...activityData.map(item => item.count), 1);\n\n // Group dates by week for the grid layout\n const weeks: Date[][] = [];\n let currentWeek: Date[] = [];\n\n dates.forEach(date => {\n const dayOfWeek = date.getDay();\n\n // Start a new week when we hit Sunday (0)\n if (dayOfWeek === 0 && currentWeek.length > 0) {\n weeks.push(currentWeek);\n currentWeek = [];\n }\n\n currentWeek.push(date);\n });\n\n // Handle the last week\n if (currentWeek.length > 0) {\n weeks.push(currentWeek);\n }\n // Fill in empty days to complete the grid\n const dayLabels = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\n // Get month labels for the top of the heatmap\n const monthLabels: { label: string; column: number }[] = [];\n let currentMonth = -1;\n\n dates.forEach((date, index) => {\n const month = date.getMonth();\n if (month !== currentMonth) {\n currentMonth = month;\n const weekIndex = Math.floor(index / 7);\n monthLabels.push({\n label: date.toLocaleString(\"default\", { month: \"short\" }),\n column: weekIndex + 2, // +2 because we have the day labels column and array is 0-indexed\n });\n }\n });\n\n // Helper to determine the color level based on activity count\n const getColorLevel = (date: Date): number => {\n const dateStr = date.toISOString().split(\"T\")[0];\n const count = activityMap.get(dateStr) || 0;\n\n if (date > today) return 0;\n\n if (count === 0) return 0;\n if (count <= maxCount * 0.125) return 1;\n if (count <= maxCount * 0.25) return 2;\n if (count <= maxCount * 0.375) return 3;\n if (count <= maxCount * 0.5) return 4;\n if (count <= maxCount * 0.625) return 5;\n if (count <= maxCount * 0.75) return 6;\n if (count <= maxCount * 0.875) return 7;\n return 8;\n };\n\n return (\n

\n {/* Month labels at the top */}\n

\n {monthLabels.map((month, i) => (\n \n {month.label}\n

\n ))}\n\n {/* Day labels on the left */}\n {dayLabels.map((day, i) => (\n \n {day}\n \n ))}\n\n {/* Activity cells */}\n {weeks.map((week, weekIndex) => (\n week.map((date, dayIndex) => {\n const colorLevel = getColorLevel(date);\n const dateStr = date.toISOString().split(\"T\")[0];\n const count = activityMap.get(dateStr) || 0;\n const formattedDate = date.toLocaleDateString(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n year: \"numeric\",\n });\n\n return (\n \n

\n {count} files on {formattedDate}\n

\n \n );\n })\n ))}\n \n );\n}\n\n// Helper to highlight the search terms in the code\nexport function highlightText(text: string, searchTerm: string): JSX.Element {\n if (!searchTerm) return <>{text};\n\n const regex = new RegExp(\n `(${searchTerm.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")})`,\n \"gi\",\n );\n const parts = text.split(regex);\n\n return (\n <>\n {parts.map((part, i) =>\n regex.test(part)\n ? {part}\n : {part}\n )}\n \n );\n}\n\n// CodeBlock component for displaying code with line numbers\nexport function CodeBlock(\n { matchedLines, searchTerm, totalMatches: _totalMatches }: {\n matchedLines: EnhancedSearchResult[\"matchedLines\"];\n searchTerm: string;\n totalMatches: number;\n },\n) {\n return (\n

\n      {matchedLines.map((line, index) => (\n        line.lineNumber === -1 ? (\n          ...
\n        ) : (\n          \n            {line.lineNumber}\n            \n              {highlightText(line.lineContent, searchTerm)}\n            \n          
\n        )\n      ))}\n

\n );\n}\n\n// File search result component\nexport function FileSearchResultComponent(\n { result, searchTerm }: { result: EnhancedSearchResult; searchTerm: string },\n) {\n const relativeTime = formatRelativeTime(result.updated_at);\n const fullDate = formatFullDate(result.updated_at);\n\n // Check for metadata matches to highlight\n const lowercaseSearchTerm = searchTerm.toLowerCase();\n const projectNameMatches = result.project_name.toLowerCase().includes(lowercaseSearchTerm);\n const fileNameMatches = result.name.toLowerCase().includes(lowercaseSearchTerm);\n const usernameMatches = result.username.toLowerCase().includes(lowercaseSearchTerm);\n\n return (\n

\n {result.image_url && (\n

\n ${result.project_name}$ \n

\n )}\n

\n \n \n {projectNameMatches\n ? highlightText(result.project_name, searchTerm)\n : result.project_name}\n \n \n \n \n {fileNameMatches\n ? highlightText(result.name, searchTerm)\n : result.name}\n \n \n \n {result.totalMatches} {result.totalMatches === 1 ? \"match\" : \"matches\"}\n \n

\n \n \n {usernameMatches\n ? <>@{highlightText(result.username, searchTerm)}\n : <>@{result.username}}\n \n \n •\n \n Updated {relativeTime}\n \n

\n \n

\n );\n}\n\n// Project search result component\nexport function ProjectSearchResultComponent(\n { result, searchTerm }: { result: ProjectSearchResult; searchTerm: string },\n) {\n const relativeTime = formatRelativeTime(result.updated_at);\n const fullDate = formatFullDate(result.updated_at);\n\n // Check for metadata matches to highlight\n const lowercaseSearchTerm = searchTerm.toLowerCase();\n const projectNameMatches = result.name.toLowerCase().includes(lowercaseSearchTerm);\n const usernameMatches = result.username.toLowerCase().includes(lowercaseSearchTerm);\n const descriptionMatches = result.description?.toLowerCase().includes(lowercaseSearchTerm);\n\n return (\n

\n {result.image_url && (\n

\n )}\n

\n \n \n {projectNameMatches\n ? highlightText(result.name, searchTerm)\n : result.name}\n \n \n {result.matchCount > 0 && (\n \n {result.matchCount} {result.matchCount === 1 ? \"file match\" : \"file matches\"}\n \n )}\n

\n \n \n {usernameMatches\n ? <>@{highlightText(result.username, searchTerm)}\n : <>@{result.username}}\n \n \n •\n \n Updated {relativeTime}\n \n

\n {result.description && (\n

\n {descriptionMatches\n ? highlightText(result.description, searchTerm)\n : result.description}\n

\n )}\n

\n );\n}\n\n// User search result component\nexport function UserSearchResultComponent(\n { result, searchTerm }: { result: UserSearchResult; searchTerm: string },\n) {\n const relativeTime = formatRelativeTime(result.updated_at);\n const fullDate = formatFullDate(result.updated_at);\n\n // Check for metadata matches to highlight\n const lowercaseSearchTerm = searchTerm.toLowerCase();\n const usernameMatches = result.username && result.username.toLowerCase().includes(lowercaseSearchTerm);\n const bioMatches = result.bio && result.bio.toLowerCase().includes(lowercaseSearchTerm);\n\n return (\n

\n {result.profile_image_url && (\n

\n )}\n

\n \n \n {usernameMatches && result.username\n ? <>@{highlightText(result.username, searchTerm)}\n : <>@{result.username || \"anonymous\"}}\n \n \n \n {result.matchCount} {result.matchCount === 1 ? \"val\" : \"vals\"}\n \n

\n \n Updated {relativeTime}\n \n

\n\n {result.bio && (\n

\n {bioMatches\n ? highlightText(result.bio, searchTerm)\n : result.bio}\n

\n )}\n

\n );\n}\n\n// Sub-section result for docs\nexport function SubDocResultComponent(\n { result, _searchTerm }: { result: SubDocResult; _searchTerm: string },\n) {\n return (\n

\n \n {result.title}\n \n

\n );\n}\n\n// Doc search result component\nexport function DocSearchResultComponent(\n { result, searchTerm }: { result: DocSearchResult; searchTerm: string },\n) {\n const titleMatches = result.meta.title.toLowerCase().includes(searchTerm.toLowerCase());\n\n return (\n

\n \n \n {titleMatches\n ? highlightText(result.meta.title, searchTerm)\n : result.meta.title}\n \n \n \n {result.word_count} words\n \n

\n {result.url}\n

\n\n

\n\n {result.sub_results && result.sub_results.length > 0 && (\n

Sections

\n {result.sub_results.map((subResult, index) => (\n \n ))}\n

\n )}\n

\n );\n}\n\n// Result count tabs component\nexport function ResultTypeTabs({\n totalFileResults,\n totalProjectResults,\n totalUserResults,\n totalDocResults,\n resultType,\n searchTerm,\n _currentPage,\n}: {\n totalFileResults: number;\n totalProjectResults: number;\n totalUserResults: number;\n totalDocResults: number;\n resultType: \"files\" | \"projects\" | \"users\" | \"docs\";\n searchTerm: string;\n _currentPage: number;\n}) {\n return (\n

\n \n Files {totalFileResults}\n \n \n Vals {totalProjectResults}\n \n \n Users {totalUserResults}\n \n \n Docs {totalDocResults}\n \n

\n );\n}\n\n// Pagination component\nexport function Pagination({\n currentPage,\n totalPages,\n searchTerm,\n resultType,\n}: {\n currentPage: number;\n totalPages: number;\n searchTerm: string;\n resultType: \"files\" | \"projects\" | \"users\" | \"docs\";\n}) {\n if (totalPages <= 1) return null;\n\n // Create an array of page numbers to display\n const pageNumbers: (number | string)[] = [];\n const maxPagesToShow = 7; // Odd number works best for symmetry\n\n if (totalPages <= maxPagesToShow) {\n // Show all pages if there are fewer than maxPagesToShow\n for (let i = 1; i <= totalPages; i++) {\n pageNumbers.push(i);\n }\n } else {\n // Always include first page\n pageNumbers.push(1);\n\n // Calculate range around current page\n const leftSide = Math.floor(maxPagesToShow / 2);\n const rightSide = maxPagesToShow - leftSide - 1;\n\n // Determine if we need to show ellipsis\n if (currentPage > leftSide + 1) {\n pageNumbers.push(\"...\");\n }\n\n // Determine the range of pages to show around current page\n let rangeStart = Math.max(2, currentPage - leftSide);\n let rangeEnd = Math.min(totalPages - 1, currentPage + rightSide);\n\n // Adjust range if at the beginning\n if (currentPage - leftSide < 2) {\n rangeEnd = Math.min(totalPages - 1, maxPagesToShow - 1);\n }\n\n // Adjust range if at the end\n if (currentPage + rightSide > totalPages - 1) {\n rangeStart = Math.max(2, totalPages - maxPagesToShow + 2);\n }\n\n // Add the range of pages\n for (let i = rangeStart; i <= rangeEnd; i++) {\n pageNumbers.push(i);\n }\n\n // Add ellipsis if needed\n if (rangeEnd < totalPages - 1) {\n pageNumbers.push(\"...\");\n }\n\n // Always include last page if not already included\n if (rangeEnd < totalPages) {\n pageNumbers.push(totalPages);\n }\n }\n\n return (\n

\n {currentPage > 1 && (\n \n « Previous\n \n )}\n\n

\n {pageNumbers.map((page, index) => (\n typeof page === \"number\"\n ? (\n \n {page}\n \n )\n : {page}\n ))}\n

\n\n {currentPage < totalPages && (\n \n Next »\n \n )}\n

\n );\n}\n\n// Sample results component for preview of other result types\nexport function SampleResultsSection({\n title,\n linkText,\n resultType,\n searchTerm,\n count,\n showNoResults = false,\n}: {\n title: string;\n linkText: string;\n resultType: \"files\" | \"projects\" | \"users\" | \"docs\";\n searchTerm: string;\n count: number;\n showNoResults?: boolean;\n}) {\n if (count === 0 && !showNoResults) return null;\n\n return (\n

{title}

\n {count > 0 && (\n \n {linkText}\n \n )}\n

\n {count === 0 && showNoResults && (\n

\n No {resultType} match your search\n

\n )}\n

\n );\n}\n\n// Main search page component\nexport function SearchPage({\n fileResults,\n projectResults,\n userResults,\n docResults,\n searchTerm,\n totalFileResults,\n totalProjectResults,\n totalUserResults,\n totalDocResults,\n currentPage,\n totalPages,\n executionTimeMs,\n requestUrl,\n resultType = \"files\",\n stats,\n}: {\n fileResults: EnhancedSearchResult[];\n projectResults: ProjectSearchResult[];\n userResults: UserSearchResult[];\n docResults: DocSearchResult[];\n searchTerm: string;\n totalFileResults: number;\n totalProjectResults: number;\n totalUserResults: number;\n totalDocResults: number;\n currentPage: number;\n totalPages: number;\n executionTimeMs: number;\n requestUrl: string;\n resultType?: \"files\" | \"projects\" | \"users\" | \"docs\";\n stats: StatsData | null;\n}) {\n const totalResults = totalFileResults + totalProjectResults + totalUserResults + totalDocResults;\n\n // Determine which results to show based on result type\n let activeResults: JSX.Element[] = [];\n const otherResults: JSX.Element[] = [];\n\n // Prepare active results based on selected type\n if (searchTerm) {\n switch (resultType) {\n case \"files\":\n activeResults = fileResults.map((result, index) => (\n \n ));\n\n // Add preview of other result types if they have results\n if (totalProjectResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample project results\n projectResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalUserResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample user results\n userResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalDocResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample doc results\n docResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n break;\n\n case \"projects\":\n activeResults = projectResults.map((result, index) => (\n \n ));\n\n // Add preview of other result types\n if (totalFileResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample file results\n fileResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalUserResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample user results\n userResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalDocResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample doc results\n docResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n break;\n\n case \"users\":\n activeResults = userResults.map((result, index) => (\n \n ));\n\n // Add preview of other result types\n if (totalFileResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample file results\n fileResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalProjectResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample project results\n projectResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalDocResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample doc results\n docResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n break;\n\n case \"docs\":\n activeResults = docResults.map((result, index) => (\n \n ));\n\n // Add preview of other result types\n if (totalFileResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample file results\n fileResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalProjectResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample project results\n projectResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n\n if (totalUserResults > 0) {\n otherResults.push(\n ,\n );\n\n // Add a few sample user results\n userResults.slice(0, 2).forEach((result, index) => {\n otherResults.push(\n ,\n );\n });\n }\n break;\n }\n }\n\n return (\n \n \n Val Town Code Search\n \n \n \n \n \n \n \n \n

\n Val Town Code Search\n 📰 Newsletter Tool\n Return to Val Town\n

API Access

\n You can access search results via JSON API by adding format=json to your query:\n

\n {searchTerm\n ? (\n \n

\n                          {new URL(`?q=${encodeURIComponent(searchTerm)}&page=${currentPage}&format=json`, requestUrl)\n                            .toString()}\n

\n \n )\n : (\n \n {new URL(`?q=example&format=json`, requestUrl).toString()}\n \n )}\n\n

\n For typeahead suggestions, use the /typeahead endpoint:\n

\n \n

\n                      {`${new URL(\"/typeahead\", requestUrl).origin}/typeahead?q=${\n                        encodeURIComponent(searchTerm || \"example\")\n                      }`}\n

\n \n

\n Returns an array of strings in format \"username\" or \"username/projectName\"\n

\n \n \n \n

\n\n \n\n {searchTerm && (\n

\n {totalResults > 0\n ? (\n

\n Found {totalResults} {totalResults === 1 ? \"result\" : \"results\"} for \"{searchTerm}\"\n \n ({executionTimeMs}ms)\n \n

\n {(totalFileResults > 0 || totalProjectResults > 0 || totalUserResults > 0 || totalDocResults > 0)\n && (\n \n )}\n

\n )\n : (\n

\n No results found for \"{searchTerm}\"{\" \"}\n \n ({executionTimeMs}ms)\n \n

\n )}\n

\n )}\n\n

\n {activeResults.length > 0 || otherResults.length > 0\n ? (\n <>\n

\n {activeResults.length > 0\n ? activeResults\n : (\n

\n No matches found in{\" \"}\n {resultType === \"files\" ? \"files\" : resultType === \"projects\" ? \"vals\" : \"users\"}.\n

Try switching to another result type using the tabs above.

\n )}\n

\n\n {activeResults.length > 0 && (\n \n )}\n\n {otherResults.length > 0 && (\n

\n {otherResults}\n

\n )}\n \n )\n : searchTerm\n ? (\n

No matching results found. Try a different search term.

\n\n {stats && (\n

\n Search across {stats.totalProjects.toLocaleString()} vals and{\" \"}\n {stats.totalFiles.toLocaleString()} files from the ValTown community\n

\n\n

Try searching for:

\n fetch\n api\n database\n image\n function\n discord\n openai\n react\n

\n )}\n

\n )\n : (\n stats && (\n

\n Search across {stats.totalProjects.toLocaleString()} vals and{\" \"}\n {stats.totalFiles.toLocaleString()} files in Val Town\n

\n\n

{stats.totalProjects.toLocaleString()}

Total Vals

\n\n

{stats.projectsLastDay.toLocaleString()}

New in Last 24h

\n\n

{stats.projectsLastWeek.toLocaleString()}

New This Week

\n\n

{stats.projectsLastMonth.toLocaleString()}

New This Month

\n\n {/* Activity Heatmap */}\n

Files Indexed

\n \n

\n\n {/* Contributors and Projects Row */}\n

\n {/* Top Contributors */}\n

Recently Active Contributors

\n {stats.topContributors.map((contributor: ContributorData, index: number) => (\n \n

\n {contributor.profile_image_url\n ? {contributor.username}

\n : (\n \n {contributor.username.charAt(0).toUpperCase()}\n

\n )}\n

\n @{contributor.username.length > 15\n ? contributor.username.substring(0, 12) + \"...\"\n : contributor.username}\n

\n {contributor.projectCount} {contributor.projectCount === 1 ? \"val\" : \"vals\"}\n

\n \n ))}\n

\n\n {/* Most Active Projects */}\n

Most Active Vals

\n {stats.mostActiveProjects.map((project: ActiveProjectData, index: number) => (\n \n

\n {project.image_url\n ? {project.name}

\n : (\n \n {project.name.charAt(0).toUpperCase()}\n

\n )}\n

{project.name}

\n by @{project.username} • {formatRelativeTime(project.updated_at)}\n

\n \n ))}\n

\n\n

Try searching for:

\n fetch\n api\n database\n image\n function\n discord\n openai\n react\n

\n )\n )}\n

\n ` 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",[254],"pulls","branches","forks","envVars",{"_266":62,"_268":62},"connections",{"_266":62,"_267":62},"count","unfilledCount","emptyCount",{"_43":253,"_32":254,"_30":255,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":327,"_13":62,"_33":20,"_35":257,"_24":25,"_167":-5,"_285":328,"_27":329},{"_43":247,"_32":248,"_30":249,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":324,"_13":62,"_33":20,"_35":251,"_24":25,"_167":-5,"_285":325,"_27":326},{"_43":239,"_32":240,"_30":241,"_161":-5,"_41":42,"_40":242,"_163":25,"_38":321,"_13":244,"_33":34,"_35":245,"_24":25,"_167":-5,"_285":322,"_27":323},{"_43":233,"_32":234,"_30":235,"_161":-5,"_41":42,"_40":162,"_163":25,"_38":318,"_13":62,"_33":34,"_35":237,"_24":25,"_167":-5,"_285":319,"_27":320},{"_43":229,"_32":28,"_30":31,"_161":-5,"_41":42,"_40":14,"_163":25,"_38":315,"_13":231,"_33":34,"_35":37,"_24":25,"_167":-5,"_285":316,"_27":317},{"_43":221,"_32":222,"_30":223,"_161":-5,"_41":42,"_40":224,"_163":25,"_38":312,"_13":226,"_33":34,"_35":227,"_24":25,"_167":-5,"_285":313,"_27":314},{"_43":215,"_32":216,"_30":217,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":309,"_13":62,"_33":20,"_35":219,"_24":25,"_167":-5,"_285":310,"_27":311},{"_43":209,"_32":210,"_30":211,"_161":-5,"_41":42,"_40":162,"_163":25,"_38":306,"_13":62,"_33":20,"_35":213,"_24":25,"_167":-5,"_285":307,"_27":308},{"_43":203,"_32":204,"_30":205,"_161":-5,"_41":42,"_40":162,"_163":25,"_38":303,"_13":62,"_33":34,"_35":207,"_24":25,"_167":-5,"_285":304,"_27":305},{"_43":196,"_32":197,"_30":198,"_161":-5,"_41":42,"_40":162,"_163":25,"_38":300,"_13":62,"_33":200,"_35":201,"_24":25,"_167":-5,"_285":301,"_27":302},{"_43":190,"_32":191,"_30":192,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":297,"_13":62,"_33":34,"_35":194,"_24":25,"_167":-5,"_285":298,"_27":299},{"_43":184,"_32":185,"_30":186,"_161":-5,"_41":42,"_40":181,"_163":25,"_38":294,"_13":162,"_33":34,"_35":188,"_24":25,"_167":-5,"_285":295,"_27":296},{"_43":176,"_32":177,"_30":178,"_161":-5,"_41":42,"_40":179,"_163":58,"_38":291,"_13":181,"_33":34,"_35":182,"_24":25,"_167":-5,"_285":292,"_27":293},{"_43":170,"_32":171,"_30":172,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":288,"_13":62,"_33":34,"_35":174,"_24":25,"_167":-5,"_285":289,"_27":290},{"_43":159,"_32":160,"_30":56,"_161":-5,"_41":42,"_40":162,"_163":58,"_38":284,"_13":62,"_33":165,"_35":166,"_24":25,"_167":168,"_285":286,"_27":287},["D",1748357183177],"children",[],[160],["D",1748357183177],[],[171],["D",1748357934767],[],[177],["D",1748357677219],[],[185],["D",1748357183177],[],[191],["D",1748357183177],[],[197],["D",1748357183177],[],[204],["D",1748357183177],[],[210],["D",1748357183177],[],[216],["D",1748357918293],[],[222],["D",1748358247382],[],[28],["D",1748357183177],[],[234],["D",1748358126464],[],[240],["D",1748357183177],[],[248],["D",1748357183177],[],[254],["D",1748357183177],{"_100":99,"_107":103},{"_100":99,"_101":-5,"_102":103,"_18":54,"_104":105,"_106":25},{"_13":85,"_32":86,"_43":42,"_87":44,"_88":89,"_90":91,"_92":50,"_93":94,"_95":96,"_97":45,"_98":99},"ctx",{"_78":-5,"_129":367,"_368":369,"_370":371,"_372":25,"_373":25,"_374":25,"_375":58,"_376":-5,"_377":-7,"_378":-7,"_379":62,"_380":25,"_381":25,"_382":-5,"_383":25,"_384":25,"_385":25,"_386":-5},"ENV",{"_338":339,"_340":341,"_342":86,"_343":344,"_345":346,"_347":348,"_349":350,"_351":352,"_353":354,"_355":356,"_357":358,"_359":360,"_361":362,"_363":364,"_365":366},"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"]

Diff · v20