\n \n

\n );\n },\n});\n\n// Home route - the message board\nconst homeRoute = new Route({\n getParentRoute: () => rootRoute,\n path: \"/\",\n component: () => {\n // Get initial data from window if available\n const initialData = window.__INITIAL_DATA__ || {};\n \n return ;\n },\n});\n\n// Create the route tree\nconst routeTree = rootRoute.addChildren([homeRoute]);\n\n// Create the router\nexport const router = createRouter({ \n routeTree,\n defaultPreload: \"intent\",\n});\n\n// Register the router for TypeScript\ndeclare module \"@tanstack/react-router\" {\n interface Register {\n router: typeof router;\n }\n}\n\n// Export the RouterProvider component with QueryClient\nexport function RouterApp() {\n return (\n \n \n \n );\n}",[],[281,274],"frontend","1e4e73da-4062-11f1-86c8-42b51c65c3df","index.tsx","019dc2f8-7e51-765d-94e4-e3025cb5583a",["D",1777092557698],"/** @jsxImportSource https://esm.sh/react@19 */\nimport { createRoot } from \"https://esm.sh/react-dom@19/client?deps=react@19\";\nimport { type Message } from \"../shared/utils.ts\";\nimport { RouterApp } from \"./router.tsx\";\n\nconst root = document.getElementById(\"root\");\nif (!root) {\n throw new Error(\"No root element found\");\n}\n\ndeclare global {\n interface Window {\n __INITIAL_DATA__: {\n initialMessages?: Message[];\n thisProjectURL?: string;\n };\n }\n}\n\ncreateRoot(root).render();",[],[281,283],"1e4e6f48-4062-11f1-86c8-42b51c65c3df","index.html","019dc2f8-7e51-765d-94e4-dfc165688ad6",["D",1777092557698],"\n\n \n \n \n React Hono Val Town Starter\n \n \n \n \n

\n \n \n \n",[],[281,290],"1e4e6106-4062-11f1-86c8-42b51c65c3df","favicon.svg","019dc2f8-7e51-765d-94e4-daefcabf4f4b",["D",1777092557698],"",[],[281,297],"1e4e5558-4062-11f1-86c8-42b51c65c3df","019dc2f8-7e51-765d-94e4-d7d16f6a34f6",["D",1777092557698],"# Frontend\n\nThis template is a classic client-side-only React app. \n\n## `index.html`\n\nThe **entrypoint** for the frontend is `/frontend/index.html`. This is the HTML page that is returned at the root from `/backend/index.ts`.\n\nThis HTML file imports `/frontend/style.css` from `/public/style.css` and `/frontend/favicon.svg` from `/frontend/favicon.svg`. Everything in `/frontend/` is mapped to `/public` by `/backend/index.ts`. This is just a convention. You could import & serve everything out of the same folder name.\n\nThis HTML file has a `

`, which is where we mount the React app.\n\nThis HTML file imports `/frontend/index.tsx` from `/public/index.tsx`, which is the **entrypoint** for all frontend JavaScript, including all the React. It is not a problem that it imports a file with a `.tsx` extension becaues browsers ignore file extensions. They only pay attention to content-types, which is great, because all these files will be returned as transpiled JS with the appropriate JS content type by [stevekrouse/utils/serve-public](https://www.val.town/x/stevekrouse/utils/branch/main/code/serve-public/README.md).)\n\n## `index.tsx`\n\nThis file is the **entrypoint** for frontend JavaScript. It imports the React app from `/frontend/components/App.tsx` and mounts it on `

`.\n\nIt also looks for *bootstrapped* JSON data at `window.__INITIAL_DATA`, and passes that only to the ``.\n\n## `favicon.svg`\n\nAs of this writing Val Town only supports text files, which is why the favicon is an SVG and not an .ico or any other binary image format. If you need binary file storage, check out [Blob Storage](https://docs.val.town/std/blob/).\n\n## `components/`\n\nThis directory is where the React components are stored. They're pretty standard client-side React components.",[],[281,87],"1e4e4db0-4062-11f1-86c8-42b51c65c3df","queries.ts","019dc2f8-7e51-765d-94e4-cefd33c55f2f","019dc2f8-7e51-765d-94e4-d3fcfa6f29f1",["D",1777092557698],"import { useQuery, useMutation, useQueryClient } from \"https://esm.sh/@tanstack/react-query@^5.0.0?deps=react@19\";\nimport { type Message } from \"../../shared/utils.ts\";\n\n// Fetch messages query\nexport function useMessages(initialData?: Message[]) {\n return useQuery({\n queryKey: [\"messages\"],\n queryFn: async () => {\n const response = await fetch(\"/api/messages\");\n if (!response.ok) {\n throw new Error(\"Failed to fetch messages\");\n }\n const data = await response.json();\n return data.reverse() as Message[];\n },\n initialData,\n staleTime: 30 * 1000, // 30 seconds\n });\n}\n\n// Post message mutation\nexport function usePostMessage() {\n const queryClient = useQueryClient();\n \n return useMutation({\n mutationFn: async (content: string) => {\n const response = await fetch(\"/api/messages\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ content }),\n });\n \n if (!response.ok) {\n throw new Error(\"Failed to post message\");\n }\n \n return response.json();\n },\n onSuccess: () => {\n // Invalidate and refetch messages\n queryClient.invalidateQueries({ queryKey: [\"messages\"] });\n },\n });\n}",[],[281,317,310],"lib","1e4e5436-4062-11f1-86c8-42b51c65c3df",["D",1777092557698],[220],[281,317],"1e4e4586-4062-11f1-86c8-42b51c65c3df","MessageInput.tsx","019dc2f8-7e51-765d-94e4-c5e4a0b77c88","019dc2f8-7e51-765d-94e4-cb0a32699049",["D",1777092557698],"/** @jsxImportSource https://esm.sh/react@19 */\nimport React from \"https://esm.sh/react@19\";\nimport { usePostMessage } from \"../lib/queries.ts\";\n\nexport function MessageInput() {\n const [message, setMessage] = React.useState(\"\");\n const postMessage = usePostMessage();\n\n const handleSubmit = async (e: React.FormEvent) => {\n e.preventDefault();\n if (!message.trim()) return;\n\n try {\n await postMessage.mutateAsync(message);\n setMessage(\"\");\n } catch (error) {\n console.error(\"Message submission failed\", error);\n }\n };\n\n return (\n

\n setMessage(e.target.value)}\n placeholder=\"Type a message...\"\n className=\"flex-1 px-3 py-2 border border-gray-300 rounded focus:outline-none focus:ring-2 focus:ring-blue-500\"\n />\n \n \n );\n}",[],[281,330,323],"components","1e4e3a8c-4062-11f1-86c8-42b51c65c3df","App.tsx","019dc2f8-7e51-765d-94e4-c1bde27103c5",["D",1777092557698],"/** @jsxImportSource https://esm.sh/react@19 */\nimport React from \"https://esm.sh/react@19\";\nimport { type Message, MESSAGE_LIMIT } from \"../../shared/utils.ts\";\nimport { MessageInput } from \"./MessageInput.tsx\";\nimport { useMessages } from \"../lib/queries.ts\";\n\nexport function App(\n { initialMessages = [], thisProjectURL }: { initialMessages?: Message[]; thisProjectURL?: string },\n) {\n const { data: messages = [], isLoading, error } = useMessages(initialMessages);\n\n if (isLoading && !initialMessages.length) {\n return (\n

Loading messages...

\n );\n }\n\n if (error) {\n return (\n

Failed to load messages

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

💬 Message Board!

\n \n \n {thisProjectURL\n ? (\n \n )\n : null}\n

\n );\n}\n\nfunction MessageList({ messages }: { messages: Message[] }) {\n const displayedMessages = messages.slice(0, MESSAGE_LIMIT);\n return (\n

\n {displayedMessages.map((msg) => )}\n

\n );\n}\n\nfunction MessageItem({ message }) {\n const formattedDate = new Date(message.timestamp).toLocaleString();\n\n return (\n

{message.content}

\n {formattedDate}\n

\n );\n}",[],[281,330,332],"1e4e4c84-4062-11f1-86c8-42b51c65c3df",["D",1777092557698],[217,218],[281,330],"1e4e8244-4062-11f1-86c8-42b51c65c3df",["D",1777092557698],[216,219,221,222,223,224,225],[281],["D",1777092557698],[],[18,75],["D",1777092557698],[],[18,87],"1e4e0f58-4062-11f1-86c8-42b51c65c3df","schema.ts","019dc2f8-7e51-765d-94e4-acd4eb5fbf23",["D",1777092557698],"import { sqliteTable, text, integer } from \"npm:drizzle-orm/sqlite-core\";\n\n// Messages table\nexport const messages = sqliteTable(\"messages\", {\n id: integer(\"id\").primaryKey({ autoIncrement: true }),\n content: text(\"content\").notNull(),\n timestamp: text(\"timestamp\").notNull().default(new Date().toISOString()),\n});\n\n// Type exports\nexport type Message = typeof messages.$inferSelect;",[],[18,92,353],"1e4e0792-4062-11f1-86c8-42b51c65c3df","019dc2f8-7e51-765d-94e4-aa2ddddbd54a",["D",1777092557698],"import { desc } from \"npm:drizzle-orm\";\nimport { db, schema } from \"./db.ts\";\nimport { createTables } from \"./migrations.ts\";\nimport { MESSAGE_LIMIT } from \"../../shared/utils.ts\";\n\n// This will create the database table if it doesn't exist.\n// This will run every time the app starts up. You can\n// comment out this line for a modest (30ms) performance improvement\n// on cold starts. It's left in to ensure the database tables are\n// automatically set up correctly for users who fork this app.\nawait createTables();\n\nexport async function getMessages(limit = MESSAGE_LIMIT) {\n const messages = await db\n .select()\n .from(schema.messages)\n .orderBy(desc(schema.messages.timestamp))\n .limit(limit)\n .all();\n \n return messages;\n}\n\nexport async function insertMessage(content: string) {\n await db\n .insert(schema.messages)\n .values({\n content,\n timestamp: new Date().toISOString(),\n })\n .run();\n}",[],[18,92,310],"1e4e035a-4062-11f1-86c8-42b51c65c3df","migrations.ts","019dc2f8-7e51-765d-94e4-a664f5277e0f",["D",1777092557698],"import { sql } from \"npm:drizzle-orm\";\nimport { db } from \"./db.ts\";\n\nexport async function createTables() {\n // Uncomment to reset database\n await db.run(sql`DROP TABLE IF EXISTS messages`);\n // Create messages table\n await db.run(sql`\n CREATE TABLE IF NOT EXISTS messages (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n content TEXT NOT NULL,\n timestamp TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n}",[],[18,92,366],"1e4e0008-4062-11f1-86c8-42b51c65c3df","db.ts","019dc2f8-7e51-765d-94e4-a174c05eb8da",["D",1777092557698],"import { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { drizzle } from \"npm:drizzle-orm/libsql\";\nimport * as schema from \"./schema.ts\";\n\n// Create Drizzle instance with Val Town's sqlite\nexport const db = drizzle(sqlite as any);\n\n// Export schema for convenience\nexport { schema };",[],[18,92,373],"1e4dd614-4062-11f1-86c8-42b51c65c3df","019dc2f8-7e50-7254-a9ee-c464d5e274d5",["D",1777092557698],"# Database\n\nThis app uses [Val Town SQLite](https://docs.val.town/std/sqlite/) to manage data. Every Val Town account comes with a free SQLite database, hosted on [Turso](https://turso.tech/). This folder is broken up into two files:\n\n* `migrations.ts` - code to set up the database tables the app needs\n* `queries.ts` - functions to run queries against those tables, which are imported and used in the main Hono server in `/backend/index.ts`\n\n## Migrations\n\nIn `backend/database/migrations.ts`, this app creates a new SQLite table `reactHonoStarter_messages` to store messages. \n\nThis \"migration\" runs once on every app startup because it's imported in `index.ts`. You can comment this line out for a slight (30ms) performance improvement on cold starts. It's left in so that users who fork this project will have the migration run correctly.\n\nSQLite has much more limited support for altering existing tables as compared to other databases. Often it's easier to create new tables with the schema you want, and then copy the data over. Happily LLMs are quite good at those sort of database operations, but please reach out in the [Val Town Discord](https://discord.com/invite/dHv45uN5RY) if you need help.\n\n## Queries\n\nThe queries file is where running the migrations happen in this app. It'd also be reasonable for that to happen in index.ts, or as is said above, for that line to be commented out, and only run when actual changes are made to your database schema.\n\nThe queries file exports functions to get and write data. It relies on shared types and data imported from the `/shared` directory.",[],[18,92,87],["D",1777092557698],[208,209,210,211,212],[18,92],["D",1777092557698],[207,213,214],[18],["D",1777092557698],{"_11":12,"_142":81},{"_11":12,"_138":-5,"_80":81,"_31":79,"_139":140,"_141":30},{"_39":40,"_13":16,"_33":36,"_128":96,"_129":70,"_130":71,"_131":100,"_132":133,"_134":135,"_136":14,"_137":12},"ctx",{"_52":-5,"_163":428,"_429":430,"_431":432,"_433":30,"_434":30,"_435":30,"_436":24,"_437":-5,"_438":-7,"_439":-7,"_440":26,"_441":30,"_442":30,"_443":-5,"_444":30,"_445":30,"_446":30,"_447":-5},"ENV",{"_399":400,"_401":402,"_403":16,"_404":405,"_406":407,"_408":409,"_410":411,"_412":413,"_414":415,"_416":417,"_418":419,"_420":421,"_422":423,"_424":425,"_426":427},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","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 · backend