Download Val Town Project

\n Download any public or unlisted Val Town project as a zip via its URL.\n setURL(e.target.value)}\n placeholder=\"https://www.val.town/x/shouser/getProjectsAsZips\"\n style={{\n display: \"block\",\n \"border\": \"1px solid black\",\n \"padding\": \"10px\",\n \"margin\": \"10px 0\",\n }}\n />\n \n Download\n \n

\n All Projects\n

\n {projects.map((project) => (\n \n \n {project.author.username}/{project.name}\n \n Download\n

\n ))}\n

\n \n );\n}",[],[179,185,191],[179,185],{"_106":201,"_99":202,"_152":203,"_154":180,"_155":138,"_156":157,"_158":120,"_108":204,"_103":33,"_160":205,"_162":206,"_163":27,"_164":-5,"_165":207,"_102":208},"6dd3fda0-f453-11ef-bc06-569c3dd06744","favicon.svg","03da2e10-d7c6-4042-b031-d8261d2abf85",["D",1740582463346],"file","",[],[179,202],{"_106":210,"_99":211,"_152":212,"_154":180,"_155":138,"_156":213,"_158":120,"_108":214,"_103":94,"_160":205,"_162":215,"_163":27,"_164":-5,"_165":216,"_102":217},"c3122abc-f85e-11ef-8043-569c3dd06744","index.html","498baa55-4148-43d3-9d01-fae67f281a18",10,["D",1741027135503],"\n\n \n \n \n Get Projects As Zips\n \n \n \n \n

\n \n \n \n",[],[179,211],{"_106":219,"_99":220,"_152":221,"_154":180,"_155":138,"_156":193,"_158":120,"_108":222,"_103":94,"_160":195,"_162":223,"_163":27,"_164":-5,"_165":224,"_102":225},"50365c68-f55a-11ef-a70e-569c3dd06744","index.tsx","6bb1d7a7-4337-4c95-bc2f-739854a2d610",["D",1740695371325],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = document.getElementById(\"root\");\nif (!root) {\n throw new Error(\"No root element found\");\n}\n\ncreateRoot(root).render();",[],[179,220],{"_106":227,"_99":228,"_152":229,"_154":180,"_155":138,"_156":193,"_158":120,"_108":230,"_103":157,"_160":205,"_162":231,"_163":27,"_164":-5,"_165":232,"_102":233},"50365e98-f55a-11ef-a70e-569c3dd06744","style.css","015e39d0-4582-4373-9352-f9568d9ee963",["D",1740695371325],"body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;\n max-width: 600px;\n margin: 0 auto;\n padding: 20px;\n background-color: #f4f4f4;\n}\n\n.message-board {\n background: white;\n border-radius: 8px;\n box-shadow: 0 4px 6px rgba(0,0,0,0.1);\n padding: 20px;\n}\n\n\n\nfooter {\n text-align: center;\n margin-top: 20px;\n}",[],[179,228],[179],{"_106":236,"_99":237,"_152":238,"_154":-5,"_155":138,"_156":239,"_158":120,"_108":240,"_103":157,"_160":205,"_162":241,"_163":27,"_164":-5,"_165":242,"_102":243},"3bc570a4-f48b-11ef-a48f-569c3dd06744","README.md","a0e2921d-74a9-4e34-a79b-988425cc7fb4",6,["D",1740606431207],"# Download Projects as a Zip\n\nThis is a proof of concept, showing how to download Val Town projects as zip files. For now, I've hardcoded my username into the code, so you can only download my public/unlisted projects. To see it working, type the name of this project **getProjectsAsZips** and press download. Waalaah!\n\nIf you fork this project, you can update the hardcoded username in frontend/MessageInput.tsx. I forked the [reactHonoStarter](https://www.val.town/x/stevekrouse/reactHonoStarter) to get started quickly (it's great), hence the weird naming and leftover code you'll see around this project.\n\n## Next Steps\nI'd love it if someone wanted to send me a PR and tackle either of these two:\n\n1. Add ability for users to input their own username\n2. Add ability for users to input their API token so they can see private projects",[],[237],"files",[149,167,177,183,189,200,209,218,226,235],"counts",{"_248":157,"_249":171,"_250":157,"_251":33},"pulls","branches","forks","envVars","contents",[254,257,260],{"_106":150,"_99":151,"_152":153,"_154":-5,"_155":138,"_156":157,"_158":120,"_108":255,"_103":33,"_160":161,"_162":-5,"_163":27,"_164":-5,"_102":256},["D",1740582463346],[151],{"_106":178,"_99":179,"_152":180,"_154":-5,"_155":138,"_156":157,"_158":120,"_108":258,"_103":33,"_160":161,"_162":-5,"_163":27,"_164":-5,"_102":259},["D",1740582463346],[179],{"_106":236,"_99":237,"_152":238,"_154":-5,"_155":138,"_156":239,"_158":120,"_108":261,"_103":157,"_160":205,"_162":241,"_163":27,"_164":-5,"_102":262},["D",1740606431207],[237],"upstream",{"_106":265,"_99":266,"_114":267,"_115":-5,"_112":113,"_21":268},"41ef0130-f2f5-11ef-891c-569c3dd06744","reactHonoExample","Example with client-side React & Hono server",{"_97":269,"_133":270},"stevekrouse","https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg","screenshots","emptyEnvVars","routes/_app.x.$handle.$name.branch.$branch.history",{"_97":98,"_99":100,"_101":43,"_104":275,"_279":280,"_377":157,"_378":27},{"_106":107,"_99":100,"_108":276,"_110":-5,"_111":27,"_112":113,"_114":-5,"_115":-5,"_12":116,"_117":118,"_119":120,"_121":-5,"_122":33,"_123":124,"_125":124,"_126":127,"_128":127,"_129":127,"_130":124,"_131":27,"_21":277,"_135":278},["D",1740582463346],{"_97":98,"_133":134},{"_103":137,"_99":43,"_106":138,"_139":107,"_140":141,"_142":143,"_144":113,"_145":146},"history",[281],{"_152":282,"_103":157,"_108":283,"_155":138,"_244":284},"ffff6849-4757-460e-a74f-947cb82d930e",["D",1740582463346],[285,289,294,299,302,311,316,321,324,329,336,339,342,351,358,362,366,372],{"_106":286,"_155":138,"_152":282,"_99":237,"_162":287,"_160":205,"_103":33,"_154":180,"_108":283,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":288},"6dd3f850-f453-11ef-bc06-569c3dd06744","# 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.",[179,237],{"_106":290,"_155":138,"_152":192,"_99":191,"_162":291,"_160":195,"_103":33,"_154":186,"_108":292,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":293},"6dd3f274-f453-11ef-bc06-569c3dd06744","/** @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}",["D",1740582463346],[179,185,191],{"_106":295,"_155":138,"_152":229,"_99":228,"_162":296,"_160":205,"_103":33,"_154":180,"_108":297,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":298},"6dd40480-f453-11ef-bc06-569c3dd06744","body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;\n max-width: 600px;\n margin: 0 auto;\n padding: 20px;\n background-color: #f4f4f4;\n}\n\n.message-board {\n background: white;\n border-radius: 8px;\n box-shadow: 0 4px 6px rgba(0,0,0,0.1);\n padding: 20px;\n}\n\n.message-input {\n display: flex;\n margin-top: 20px;\n}\n\n.message-input input {\n flex-grow: 1;\n padding: 10px;\n border: 1px solid #ddd;\n border-radius: 4px;\n margin-right: 10px;\n}\n\n.message-input button {\n padding: 10px 15px;\n background-color: #007bff;\n color: white;\n border: none;\n border-radius: 4px;\n cursor: pointer;\n}\n\n.message-list {\n max-height: 400px;\n overflow-y: auto;\n}\n\n.message-item {\n background-color: #f9f9f9;\n border-radius: 4px;\n padding: 10px;\n margin-bottom: 10px;\n}\n\n.message-item p {\n margin: 0 0 5px 0;\n}\n\n.message-item small {\n color: #888;\n font-size: 0.7em;\n}\n\nfooter {\n text-align: center;\n margin-top: 20px;\n}",["D",1740582463346],[179,228],{"_106":184,"_155":138,"_152":186,"_99":185,"_162":-5,"_160":161,"_103":33,"_154":180,"_108":300,"_156":157,"_164":-5,"_158":120,"_163":27,"_102":301},["D",1740582463346],[179,185],{"_106":303,"_155":138,"_152":304,"_99":305,"_162":306,"_160":195,"_103":33,"_154":307,"_108":308,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":309},"6dd40d5e-f453-11ef-bc06-569c3dd06744","4df91d83-79a6-4622-939e-2addea28d63c","utils.ts","export interface Message {\n content: string;\n}\n\nexport const MESSAGE_LIMIT = 5;","7a720519-1bc3-4623-b21e-ee5f7fa145ff",["D",1740582463346],[310,305],"shared",{"_106":312,"_155":138,"_152":118,"_99":169,"_162":313,"_160":172,"_103":33,"_154":153,"_108":314,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":315},"6dd3ed42-f453-11ef-bc06-569c3dd06744","import { parseProject } from \"https://esm.town/v/std/parseImportMeta@149-main/project\";\nimport { readFile, servePublicFile } from \"https://esm.town/v/stevekrouse/utils@187-main/serve-public/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { getMessages, insertMessage } from \"./database/queries.ts\";\n\nconst app = new Hono();\n\n// Serve index.html at the root /\napp.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Bootstrap the initial messages data into index.html\n // To avoid an extra request and loading flash\n const initialMessages = await getMessages();\n\n // Get this project's URL, in a way that works across forks and branches\n const projectVal = parseProject(import.meta.url);\n const thisProjectURL = projectVal.links.self.project;\n\n // Inject the data as a global variable inside a script tag\n const dataScript = ``;\n\n // Insert the script right before the closing tag\n html = html.replace(\"\", `${dataScript}`);\n\n return c.html(html);\n});\n\n// Serve all /frontend files under /public\napp.get(\"/public/**/*\", c => servePublicFile(c.req.path.replace(\"/public\", \"/frontend\"), import.meta.url));\n\n// Serve all /shared files under /shared\napp.get(\"/shared/**/*\", c => servePublicFile(c.req.path, import.meta.url));\n\n// Provide an endpoint for the frontend to get messages as JSON\napp.get(\"/messages\", async (c) => {\n const messages = await getMessages();\n return c.json(messages);\n});\n\n// Provide an endpoint for the frontend to insert a new message\napp.post(\"/messages\", async (c) => {\n const { content } = await c.req.json();\n\n if (!content || content.trim() === \"\") {\n return c.json({ error: \"Message cannot be empty\" }, 400);\n }\n\n await insertMessage(content);\n\n return c.json({ success: true }, 201);\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err, c) => {\n throw err;\n});\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;",["D",1740582463346],[151,169],{"_106":317,"_155":138,"_152":221,"_99":220,"_162":318,"_160":195,"_103":33,"_154":180,"_108":319,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":320},"6dd4025a-f453-11ef-bc06-569c3dd06744","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { type Message } from \"../shared/utils.ts\";\nimport { App } from \"./components/App.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();",["D",1740582463346],[179,220],{"_106":150,"_155":138,"_152":153,"_99":151,"_162":-5,"_160":161,"_103":33,"_154":-5,"_108":322,"_156":157,"_164":-5,"_158":120,"_163":27,"_102":323},["D",1740582463346],[151],{"_106":325,"_155":138,"_152":212,"_99":211,"_162":326,"_160":205,"_103":33,"_154":180,"_108":327,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":328},"6dd3ff3a-f453-11ef-bc06-569c3dd06744","\n\n \n \n \n React Hono Val Town Starter\n \n \n \n \n

\n \n \n",["D",1740582463346],[179,211],{"_106":330,"_155":138,"_152":331,"_99":332,"_162":333,"_160":195,"_103":33,"_154":186,"_108":334,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":335},"6dd3f4ea-f453-11ef-bc06-569c3dd06744","01d0cd08-fdb0-46f8-8efa-b87bb7404a74","MessageInput.tsx","/** @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}",["D",1740582463346],[179,185,332],{"_106":201,"_155":138,"_152":203,"_99":202,"_162":206,"_160":205,"_103":33,"_154":180,"_108":337,"_156":157,"_164":-5,"_158":120,"_163":27,"_102":338},["D",1740582463346],[179,202],{"_106":178,"_155":138,"_152":180,"_99":179,"_162":-5,"_160":161,"_103":33,"_154":-5,"_108":340,"_156":157,"_164":-5,"_158":120,"_163":27,"_102":341},["D",1740582463346],[179],{"_106":343,"_155":138,"_152":344,"_99":345,"_162":346,"_160":195,"_103":33,"_154":347,"_108":348,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":349},"6dd3de88-f453-11ef-bc06-569c3dd06744","0174984d-9d1c-4b7f-a0b1-b9fd5697dd09","migrations.ts","import { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\n\nexport const tableName = \"reactHonoStarter_messages\";\n\nexport async function createTables() {\n await sqlite.batch([\n `CREATE TABLE IF NOT EXISTS ${tableName} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n content TEXT NOT NULL,\n timestamp DATETIME DEFAULT CURRENT_TIMESTAMP\n )`,\n /* Add any other tables or migrations you want here\n\n However, you should know that SQLite has much more limited\n support for altering existing tables as compared to other databases.\n Often it's easier to create new tables with the schema you want, and then\n copy the data over. */\n ]);\n}","487934d6-a110-4cde-8770-136729fc540a",["D",1740582463346],[151,350,345],"database",{"_106":352,"_155":138,"_152":353,"_99":354,"_162":355,"_160":195,"_103":33,"_154":347,"_108":356,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":357},"6dd3e20c-f453-11ef-bc06-569c3dd06744","9d4b8fe5-5e67-4e1e-b475-4fb0a91a1c1c","queries.ts","import { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nimport { type Message, MESSAGE_LIMIT } from \"../../shared/utils.ts\";\nimport { createTables, tableName } from \"./migrations.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) perforamnce 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): Promise {\n const messages = await sqlite.execute(\n `SELECT * FROM ${tableName} \n ORDER BY timestamp DESC \n LIMIT ?`,\n [limit],\n );\n return messages.rows as unknown as Message[];\n}\n\nexport async function insertMessage(content: string) {\n await sqlite.execute(\n `INSERT INTO ${tableName} (content) \n VALUES (?)`,\n [content],\n );\n}",["D",1740582463346],[151,350,354],{"_106":359,"_155":138,"_152":307,"_99":310,"_162":-5,"_160":161,"_103":33,"_154":-5,"_108":360,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":361},"6dd40eda-f453-11ef-bc06-569c3dd06744",["D",1740582463346],[310],{"_106":363,"_155":138,"_152":347,"_99":350,"_162":-5,"_160":161,"_103":33,"_154":153,"_108":364,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":365},"6dd3e46e-f453-11ef-bc06-569c3dd06744",["D",1740582463346],[151,350],{"_106":367,"_155":138,"_152":368,"_99":237,"_162":369,"_160":205,"_103":33,"_154":307,"_108":370,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":371},"6dd40bc4-f453-11ef-bc06-569c3dd06744","2932c059-ff75-4a32-8798-e07ca51ef9c4","# Shared\n\nIt's common to have code and types that are needed on both the frontend and the backend. It's important that you write this code in a particularly defensive way because it's limited by what both environments support:\n\n![shapes at 25-02-25 11.57.13.png](https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/75db1d51-d9b3-45e0-d178-25d886c10700/public)\n\nFor example, you *cannot* use the `Deno` keyword. For imports, you can't use `npm:` specifiers, so we reccomend `https://esm.sh` because it works on the server & client. You *can* use TypeScript because that is transpiled in `/backend/index.ts` for the frontend. Most code that works on the frontend tends to work in Deno, because Deno is designed to support \"web-standards\", but there are definitely edge cases to look out for.",["D",1740582463346],[310,237],{"_106":373,"_155":138,"_152":238,"_99":237,"_162":374,"_160":205,"_103":33,"_154":-5,"_108":375,"_156":157,"_164":-5,"_158":27,"_163":27,"_102":376},"6dd40fc0-f453-11ef-bc06-569c3dd06744","# React Hono Val Town Project Starter Template\n\nThis is a starter template for a full-stack app in a Val Town Project. The app itself is a simple persistent message board.\n\nThis app is broken up into three folders, corresponding to where the code in those folders run:\n\n- `backend/` - runs on Val Town serverless infrastructure in Deno\n- `frontend/` - runs in the user's browser\n- `shared/` - runs in both the frontend and backend\n\nThe entrypoint of this app is `backend/index.ts`, which is the Hono HTTP server, which serves the HTML, CSS, and JS, which run client-side.\n\nYou can click into each of those folders to view their respective READMEs.\n\n## Getting started\n\n1. Click `Fork` on the top-right to run this Project on your account.\n2. Go to `/backend/index.ts` and click on the ... menu on the HTTP Preview and click **Pin to Home**. (We will soon do this for you automatically.)\n3. Customize the project for your own use-case!\n\n## Contributing\n\nThis template is actively accepting pull requests, particularly for bugs, but also for anything that can be done more idiomatically.\n\nIf you'd like to make a template with other technologies choices (ie no Hono or no React), please create a new template and we can link to it from this one as another way to go. Eventually, we'd like to be many templates that show how to use Projects. The next one I'm personally excited about making is a fullstack React Router 7 one. [This one](https://www.val.town/x/just_be/reactRouter7) is a good start, but I'd like to rebuild the message board app from this template in that format.",["D",1740582463346],[237],"page","hasNext","routes/_app","actionData","errors"]

History