React Starter

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_238":239,"_240":241},"routes/_app.x.$handle.$name",{"_99":98,"_31":43,"_108":85,"_26":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_20":-5,"_120":121,"_122":123,"_124":24,"_125":126,"_127":57,"_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",{"_41":42,"_31":43,"_36":44,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":55,"_56":57,"_58":57,"_59":-5,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":-5,"_67":-5,"_68":69,"_70":69,"_71":72,"_73":72,"_74":72,"_75":69,"_76":69,"_77":78,"_79":80,"_81":82,"_83":24},"version",4,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":27,"_32":33,"_34":35,"_36":37,"_38":14,"_39":40,"_23":24},"previous","deleted",false,"deletedHere","path","projects.ts","latestPath","fileId","ab0a6e4a-a2e3-11f0-b3e9-0224a6c84d84","name","fileType","script","content","export const projects = [\n {\n name: \"Habit Tracker\",\n description: \"React app where you can create various habits to track\",\n size: \"medium\",\n },\n {\n name: \"“Git Ingest” for Val.Town\",\n description:\n \"Get the contents of a val through esm.town, and then be able to copy it to the clipboard, or save it as a txt file\",\n size: \"large\",\n },\n {\n name: \"ChatGPT to create project ideas\",\n description: \"Click a button to get a project idea!\",\n size: \"small\",\n },\n {\n name: \"(MAKE FIRST) Project-picker randomizer\",\n description:\n \"Export all the project ideas, make a “spinner” val that tells me which project to do next.\",\n size: \"medium\",\n },\n {\n name: \"Code Golfer\",\n description:\n \"Copy paste code and have ChatGPT golf it, provide a way to un-golf it as well\",\n size: \"medium\",\n },\n {\n name: \"Arithmetic challenge \",\n description: \"50 questions in 60 seconds\",\n size: \"small\",\n },\n {\n name: \"Reading challenge\",\n description:\n \"Read an AI generated story about a topic, then doing a reading exam\",\n size: \"medium\",\n },\n {\n name: \"Daily Gratitude Form\",\n description:\n \"Generate a few questions that are about gratitude, save answers to a database\",\n size: \"large\",\n },\n {\n name: \"Random Gradient Generator\",\n description:\n \"Generate beautiful CSS gradients with a single click. Returns HTML page with gradient + copy-paste CSS.\",\n size: \"small\",\n },\n {\n name: \"ASCII Art Generator\",\n description: \"Convert text into ASCII art banners using a simple font map.\",\n size: \"small\",\n },\n {\n name: \"Live Clock Many Timezones\",\n description:\n \"Display current time in 5+ interesting cities with emoji flags.\",\n size: \"small\",\n },\n {\n name: \"Character Counter\",\n description: \"Paste in URI and get length of character’s back\",\n size: \"small\",\n },\n {\n name: \"Timestamp Converter\",\n description: \"Convert from epoch date to human readable date\",\n size: \"small\",\n },\n {\n name: \"“Datle”\",\n description:\n \"Make your own “wordle” game where you are given a epoch date and have to guess the actual date in as few guesses as possible\",\n size: \"large\",\n },\n {\n name: \"ChatGPT magic 8 ball\",\n description: \"Use an AI to answer a question, design it like an 8 Ball\",\n size: \"small\",\n },\n {\n name: \"Dad joke generator\",\n description: \"What am I, chopped liver?\",\n size: \"small\",\n },\n {\n name: \"Dice roller\",\n description:\n \"Choose various combinations of dice and generate random numbers for each one\",\n size: \"small\",\n },\n {\n name: \"Coin Flip API\",\n description: \"It’s an API that either passes or fails 50/50\",\n size: \"small\",\n },\n {\n name: \"Tip calculator\",\n description:\n \"Put in the total bill, number of guests, and tells you how much everyone should pay\",\n size: \"small\",\n },\n {\n name: \"Dog time calculator\",\n description:\n \"Input an age, get back that age in dog years. Figure out how dog years are defined and extrapolate it to other animals? What’s a dog hour?\",\n size: \"small\",\n },\n {\n name: \"Nato Alphabet quiz\",\n description: null,\n size: \"small\",\n },\n {\n name: \"Country flag quiz\",\n description: null,\n size: \"medium\",\n },\n {\n name: \"OpenAI Realtime sleepcast\",\n description:\n \"Use the https://www.val.town/x/stevekrouse/hello-realtime to generate a “Sleepcast” that puts you to sleep\",\n size: \"small\",\n },\n];\n","createdAt",["D",1759775915925],"branchVersion","branchId","057a5ed6-a2e3-11f0-b5fc-0224a6c84d84","id","05768a5e-a2e3-11f0-b5fc-0224a6c84d84","project-picker",["D",1759775638102],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Project picker to create as many vals as possible in 2 hours","imageUrl","019977b1-1bd1-730d-a575-2665305dd849","pinnedFileId","0199bacd-42a0-74ca-9ae6-47c50a786ccf","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019977b1-1bd1-730d-a575-2afdc309b42c","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_99":98,"_107":103},"org",{"_99":98,"_100":101,"_102":103,"_18":53,"_104":105,"_106":24},"branch",{"_13":84,"_31":85,"_41":40,"_86":42,"_87":88,"_89":90,"_91":48,"_92":93,"_94":95,"_96":43,"_97":98},"isOwned",14,"main","projectId","forkedBranchId","0d303272-0b30-11f0-ad54-569c3dd06744","forkedBranchVersion",39,"forkedProjectPrivacy","forkedProjectId","0d2fd17e-0b30-11f0-ad54-569c3dd06744","forkedProjectOrgId","62a75f8d-be32-4eaa-989a-23f3433a7d42","projectName","userHandle","willemhelmet","handle","displayName","WHP","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18zMzZ1Q1ZnYnREY3RBMjh5TWtPbU5vS01MejYifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_41":42,"_31":43,"_36":234,"_45":-5,"_46":24,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":55,"_56":57,"_58":57,"_59":-5,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":-5,"_67":-5,"_68":69,"_70":69,"_71":72,"_73":72,"_74":72,"_75":69,"_76":69,"_77":235,"_79":236,"_81":237,"_83":24},"tree",[205,206,207,208,209,210,211],"files",[205,206,207,208,209,210,211],"counts",{"_195":61,"_196":158,"_197":61,"_198":199,"_200":201},"contents",[143,144,145,146,147,148,149],"upstreamProject",{"_41":93,"_31":138,"_50":139,"_52":140,"_47":48,"_77":141},"upstreamBranch",{"_41":88,"_36":132,"_133":134,"_31":85,"_86":93,"_13":90,"_87":-5,"_89":-5,"_135":136,"_45":-5,"_83":24,"_47":48,"_97":137,"_62":95,"_96":138},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1743096145603],"updatedAt",["D",1743197735178],"lockfileKey","1744626893628-esm.town_v_jxnblk_react-starter@39-main","jxnblk","react-starter","Minimal React starter with SSR","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/a0afa007-3e32-4914-a751-f7efceecae00/square512?exp=1789567199&sig=6ed3d5888721a1cff3ccebcf5fb93dc6e44cbab8c8e2a0acd2a8e13e833562a6",{"_99":137,"_107":142},"https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/fca87e60-4ad1-453c-af10-2782c6823400/square512?exp=1789567199&sig=fae5a8a7d9015b956a0fe60c6ab21169e2ada2c167fa7e66377324ad4f64834f",{"_41":188,"_31":189,"_29":190,"_151":-5,"_39":40,"_38":191,"_152":57,"_36":192,"_13":61,"_32":20,"_34":193,"_23":24,"_154":-5,"_26":194},{"_41":182,"_31":183,"_29":184,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":185,"_13":61,"_32":33,"_34":186,"_23":24,"_154":-5,"_26":187},{"_41":176,"_31":177,"_29":178,"_151":-5,"_39":40,"_38":158,"_152":24,"_36":179,"_13":61,"_32":20,"_34":180,"_23":24,"_154":-5,"_26":181},{"_41":170,"_31":171,"_29":172,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":173,"_13":61,"_32":33,"_34":174,"_23":24,"_154":-5,"_26":175},{"_41":163,"_31":164,"_29":165,"_151":-5,"_39":40,"_38":166,"_152":57,"_36":167,"_13":61,"_32":20,"_34":168,"_23":24,"_154":-5,"_26":169},{"_41":156,"_31":157,"_29":55,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":159,"_13":61,"_32":160,"_34":161,"_23":24,"_154":-5,"_26":162},{"_41":150,"_31":27,"_29":30,"_151":-5,"_39":40,"_38":14,"_152":57,"_36":153,"_13":61,"_32":33,"_34":35,"_23":24,"_154":-5,"_26":155},"ab0a6d6e-a2e3-11f0-b3e9-0224a6c84d84","parentId","latest",["D",1759775915925],"label",[27],"057da622-a2e3-11f0-b5fc-0224a6c84d84","http.tsx",1,["D",1759775638102],"http","/** @jsxImportSource https://esm.sh/react@19 */\nimport React from \"https://esm.sh/react@19\";\nimport { renderToString } from \"https://esm.sh/react-dom@19/server\";\nimport App from \"./App.tsx\";\n\nconst CLIENT_MODULE = import.meta.url.replace(\"http.tsx\", \"client.tsx\");\n\nexport default async function (req: Request): Promise {\n const app = renderToString();\n const html = `\n \n \n React Starter\n \n \n

${app}

\n \n \n \n `;\n\n return new Response(html, {\n headers: {\n \"Content-Type\": \"text/html\",\n },\n });\n}",[157],"ab03f038-a2e3-11f0-a39a-0224a6c84d84","deno.json","ab03f0d8-a2e3-11f0-a39a-0224a6c84d84",2,["D",1759775915886],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\n \"deno:/https/esm.town/**/*\"\n ]\n },\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\"\n ]\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}",[164],"057da456-a2e3-11f0-b5fc-0224a6c84d84","client.tsx","0199bacd-42a0-74ca-9ae6-405500aef995",["D",1759775638102],"/** @jsxImportSource https://esm.sh/react@19 */\nimport React from \"https://esm.sh/react@19\"\nimport { hydrateRoot } from \"https://esm.sh/react-dom@19/client\";\nimport App from \"./App.tsx\"\n\nconst div = document.getElementById(\"app\");\nhydrateRoot(div, );",[171],"057da1ae-a2e3-11f0-b5fc-0224a6c84d84","README.md","0199bacd-42a0-74ca-9ae6-3f64f66d7dc6",["D",1759775638102],"# React Starter\n\nMinimal React SSR example for Val Town\n[View Demo](https://jxnblk--122089bc0b3011f09093569c3dd06744.web.val.run/)\n\nRemix this project to start building your own React app\n\n## How it works\n\nThe `http.tsx` file is the main entry point and serves the app.\nIt renders the `App` component on the server and wraps it in an HTML response.\nThis HTML response includes a `` 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",[189],"pulls","branches","forks","envVars",{"_202":61,"_204":61},"connections",{"_202":61,"_203":61},"count","unfilledCount","emptyCount",{"_41":188,"_31":189,"_29":190,"_151":-5,"_39":40,"_38":191,"_152":57,"_36":231,"_13":61,"_32":20,"_34":193,"_23":24,"_154":-5,"_213":232,"_26":233},{"_41":182,"_31":183,"_29":184,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":228,"_13":61,"_32":33,"_34":186,"_23":24,"_154":-5,"_213":229,"_26":230},{"_41":176,"_31":177,"_29":178,"_151":-5,"_39":40,"_38":158,"_152":24,"_36":225,"_13":61,"_32":20,"_34":180,"_23":24,"_154":-5,"_213":226,"_26":227},{"_41":170,"_31":171,"_29":172,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":222,"_13":61,"_32":33,"_34":174,"_23":24,"_154":-5,"_213":223,"_26":224},{"_41":163,"_31":164,"_29":165,"_151":-5,"_39":40,"_38":166,"_152":57,"_36":219,"_13":61,"_32":20,"_34":168,"_23":24,"_154":-5,"_213":220,"_26":221},{"_41":156,"_31":157,"_29":55,"_151":-5,"_39":40,"_38":158,"_152":57,"_36":216,"_13":61,"_32":160,"_34":161,"_23":24,"_154":-5,"_213":217,"_26":218},{"_41":150,"_31":27,"_29":30,"_151":-5,"_39":40,"_38":14,"_152":57,"_36":212,"_13":61,"_32":33,"_34":35,"_23":24,"_154":-5,"_213":214,"_26":215},["D",1759775915925],"children",[],[27],["D",1759775638102],[],[157],["D",1759775915886],[],[164],["D",1759775638102],[],[171],["D",1759775638102],[],[177],["D",1759775638102],[],[183],["D",1759775915906],[],[189],["D",1759775638102],{"_99":98,"_107":103},{"_99":98,"_100":101,"_102":103,"_18":53,"_104":105,"_106":24},{"_13":84,"_31":85,"_41":40,"_86":42,"_87":88,"_89":90,"_91":48,"_92":93,"_94":95,"_96":43,"_97":98},"ctx",{"_77":-5,"_129":271,"_272":273,"_274":275,"_276":24,"_277":24,"_278":24,"_279":57,"_280":-5,"_281":-7,"_282":-7,"_283":61,"_284":24,"_285":24,"_286":-5,"_287":24,"_288":24,"_289":24,"_290":-5},"ENV",{"_242":243,"_244":245,"_246":85,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270},"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 · v4