\n \n \n \n",[],[262,272],"d7f55e56-f2f8-11ef-9d58-569c3dd06744","favicon.svg","28592b82-f2f6-11ef-b93c-569c3dd06744",55,["D",1740433606067],4,"",[],[262,280],"6cffa980-7a0c-11f0-948e-0224a6c84d84","291f68ac-f39a-11ef-af83-569c3dd06744",["D",1755285423526],11,"# Frontend\n\nThis template is a classic client-side-only React app.\n\n## `index.html`\n\nThe **entrypoint** for the frontend is\n[`/frontend/index.html`](/frontend/index.html). This is the HTML page that is\nreturned at the root from [`../index.ts`](../index.ts).\n\nThis HTML file imports `/frontend/style.css` from [`/public/style.css`] and\n`/frontend/favicon.svg` from `/frontend/favicon.svg`. Everything in `/frontend/`\nis mapped to `/public` by `/backend/index.ts`. This is just a convention. You\ncould import & serve everything out of the same folder name.\n\nThis HTML file has a `

`, which is where we mount the React\napp.\n\nThis HTML file imports `/frontend/index.tsx` from `/public/index.tsx`, which is\nthe **entrypoint** for all frontend JavaScript, including all the React. It is\nnot a problem that it imports a file with a `.tsx` extension becaues browsers\nignore file extensions. They only pay attention to content-types, which is\ngreat, because all these files will be returned as transpiled JS with the\nappropriate JS content type by\n[std/utils](https://www.val.town/x/std/utils/code) functions.\n\n## [`index.tsx`](./index.tsx)\n\nThis file is the **entrypoint** for frontend JavaScript. It imports the React\napp from `/frontend/components/App.tsx` and mounts it on\n`

`.\n\nIt also looks for _bootstrapped_ JSON data at `window.__INITIAL_DATA`, and\npasses that only to the ``.\n\n## [`favicon.svg`](./favicon.svg)\n\nAs of this writing Val Town only supports text files, which is why the favicon\nis an SVG and not an .ico or any other binary image format. If you need binary\nfile 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\nclient-side React components.",[],[262,64],"34abf3c8-f2fc-11ef-a6a5-569c3dd06744","MessageInput.tsx","5056705e-f2f6-11ef-9d1d-569c3dd06744","3e182b80-f2f6-11ef-bcc1-569c3dd06744",87,["D",1740435050106],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport type { Message } from \"../shared/types.ts\";\n\nexport function MessageInput({ onSubmit }: { onSubmit: () => void }) {\n const [message, setMessage] = React.useState(\"\");\n\n const handleSubmit = async (e: React.FormEvent) => {\n e.preventDefault();\n if (!message.trim()) return;\n\n try {\n const response = await fetch(\"/messages\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ content: message }),\n });\n\n if (response.ok) {\n onSubmit();\n setMessage(\"\");\n }\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 />\n \n \n );\n}",[],[262,304,296],"components","099c2f5a-fdf0-11ef-9bde-569c3dd06744","App.tsx","420ddac8-f2f6-11ef-8b94-569c3dd06744",222,["D",1741639286681],19,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { type Message, MESSAGE_LIMIT } from \"../../shared/utils.ts\";\nimport { MessageInput } from \"./MessageInput.tsx\";\n\nexport function App(\n { initialMessages = [], thisProjectURL }: { initialMessages?: Message[]; thisProjectURL?: string },\n) {\n const [messages, setMessages] = React.useState(initialMessages);\n\n const fetchMessages = async () => {\n try {\n const response = await fetch(\"/messages\");\n const data = await response.json();\n setMessages(data.reverse());\n } catch (error) {\n console.error(\"Failed to fetch messages\", error);\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}",[],[262,304,306],"403f78aa-f2f6-11ef-9cc3-569c3dd06744",21,["D",1740432492545],[200,201],[262,304],"fcc80146-f2f5-11ef-9dac-569c3dd06744",10,["D",1740432379356],2,[199,202,203,204,205,206],[262],"0dd0d588-7a0c-11f0-a2cf-0224a6c84d84","469833c0-f389-11ef-9c27-569c3dd06744",240,["D",1755285263836],20,"# Backend\n\nThis folder contains all backend-only code in this project. It's broken up into:\n\n- [`../index.ts`](../index.ts) - this is the **entrypoint** for this whole\n project, which is why it's in the folder above this one, even though it's\n technically part of the backend\n- `database/` - this contains the code for interfacing with the app's SQLite\n database table\n\n## Hono\n\nThis app uses [Hono](https://hono.dev/) as the API framework. You can think of\nHono as a replacement for [ExpressJS](https://expressjs.com/) that works in\nserverless environments like Val Town or Cloudflare Workers. If you come from\nPython or Ruby, Hono is also a lot like\n[Flask](https://github.com/pallets/flask) or\n[Sinatra](https://github.com/sinatra/sinatra), respectively.\n\n## Serving assets to the frontend\n\nThis backend HTTP server is responsible for serving all static assets to the\nbrowser to render the app, including HTML, JavaScript (including all client-side\nReact), CSS, and even the favicon SVG.\n\nWe use helper functions from [std/utils](https://www.val.town/x/std/utils/code)\nfor getting files and serving them.\n\n### `index.html`\n\nThe most complicated part of this backend API is serving index.html. In this app\n(like most apps) we serve it at the root, ie `GET /`.\n\nWe _bootstrap_ `index.html` with some initial data from the server, so that it\ngets dynamically injected JSON data without having to make another round-trip\nrequest to the server to get that data on the frontend. This is a common pattern\nfor client-side rendered apps.\n\n## CRUD API Routes\n\nThis app has two CRUD API routes: for reading and inserting into the messages\ntable. They both speak JSON, which is standard. They import their functions from\n`/backend/database/queries.ts`. These routes are called from the React app to\nrefresh and update data.\n\n## Errors\n\nHono and other API frameworks have a habit of swallowing up Errors. We turn off\nthis default behavior by re-throwing errors, because we think most of the time\nyou'll want to see the full stack trace instead of merely \"Internal Server\nError\". You can customize how you want errors to appear.",[],[155,64],["D",1740496288240],[],[155,71,160],["D",1740495476659],[],[155,71,169],["D",1755285199794],[],[155,71,64],["D",1740492502332],[194,195,196],[155,71],"d359cd26-f2f5-11ef-954c-569c3dd06744",8,["D",1740432309849],[193,197],[155],["D",1740432065884],{"_11":12,"_123":69},{"_11":12,"_119":-5,"_68":69,"_31":67,"_120":121,"_122":30},{"_39":110,"_13":16,"_33":36,"_111":74,"_112":-5,"_113":-5,"_114":-5,"_115":-5,"_116":-5,"_117":14,"_118":12},"ctx",{"_52":-5,"_142":387,"_388":389,"_390":391,"_392":30,"_393":30,"_394":30,"_395":24,"_396":-5,"_397":-7,"_398":-7,"_399":26,"_400":30,"_401":30,"_402":-5,"_403":30,"_404":30,"_405":30,"_406":-5},"ENV",{"_358":359,"_360":361,"_362":16,"_363":364,"_365":366,"_367":368,"_369":370,"_371":372,"_373":374,"_375":376,"_377":378,"_379":380,"_381":382,"_383":384,"_385":386},"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 · database