\n \n \n \n","label",[177,68],"frontend","pulls","branches","forks","envVars",{"_185":26,"_187":26},"connections",{"_185":26,"_186":26},"count","unfilledCount","emptyCount",{"_33":361,"_13":319,"_66":312,"_43":-5,"_35":36,"_170":40,"_171":94,"_37":362,"_39":26,"_69":239,"_173":-5,"_70":24,"_175":-5,"_216":363,"_17":364},{"_33":357,"_13":342,"_66":337,"_43":312,"_35":36,"_170":40,"_171":94,"_37":358,"_39":26,"_69":239,"_173":-5,"_70":24,"_175":-5,"_216":359,"_17":360},{"_33":350,"_13":211,"_66":351,"_43":337,"_35":36,"_170":352,"_171":94,"_37":353,"_39":40,"_69":21,"_173":354,"_70":24,"_175":-5,"_216":355,"_17":356},{"_33":343,"_13":344,"_66":345,"_43":337,"_35":36,"_170":40,"_171":94,"_37":346,"_39":26,"_69":225,"_173":347,"_70":24,"_175":-5,"_216":348,"_17":349},{"_33":334,"_13":335,"_66":336,"_43":337,"_35":36,"_170":323,"_171":94,"_37":338,"_39":223,"_69":225,"_173":339,"_70":24,"_175":-5,"_216":340,"_17":341},{"_33":327,"_13":211,"_66":328,"_43":312,"_35":36,"_170":329,"_171":94,"_37":330,"_39":40,"_69":21,"_173":331,"_70":24,"_175":-5,"_216":332,"_17":333},{"_33":320,"_13":321,"_66":92,"_43":312,"_35":36,"_170":117,"_171":94,"_37":322,"_39":323,"_69":315,"_173":324,"_70":24,"_175":-5,"_216":325,"_17":326},{"_33":309,"_13":310,"_66":311,"_43":312,"_35":36,"_170":313,"_171":94,"_37":314,"_39":40,"_69":315,"_173":316,"_70":24,"_175":-5,"_216":317,"_17":318},{"_33":305,"_13":177,"_66":169,"_43":-5,"_35":36,"_170":40,"_171":94,"_37":306,"_39":26,"_69":239,"_173":-5,"_70":24,"_175":-5,"_216":307,"_17":308},{"_33":301,"_13":284,"_66":278,"_43":169,"_35":36,"_170":40,"_171":94,"_37":302,"_39":26,"_69":239,"_173":-5,"_70":24,"_175":-5,"_216":303,"_17":304},{"_33":293,"_13":294,"_66":295,"_43":278,"_35":36,"_170":296,"_171":94,"_37":297,"_39":40,"_69":225,"_173":298,"_70":24,"_175":-5,"_216":299,"_17":300},{"_33":285,"_13":286,"_66":287,"_43":278,"_35":36,"_170":288,"_171":94,"_37":289,"_39":26,"_69":225,"_173":290,"_70":24,"_175":-5,"_216":291,"_17":292},{"_33":275,"_13":276,"_66":277,"_43":278,"_35":36,"_170":279,"_171":94,"_37":280,"_39":26,"_69":225,"_173":281,"_70":24,"_175":-5,"_216":282,"_17":283},{"_33":268,"_13":211,"_66":269,"_43":169,"_35":36,"_170":270,"_171":94,"_37":271,"_39":40,"_69":21,"_173":272,"_70":24,"_175":-5,"_216":273,"_17":274},{"_33":261,"_13":262,"_66":263,"_43":169,"_35":36,"_170":40,"_171":94,"_37":264,"_39":26,"_69":21,"_173":265,"_70":24,"_175":-5,"_216":266,"_17":267},{"_33":168,"_13":68,"_66":67,"_43":169,"_35":36,"_170":76,"_171":94,"_37":258,"_39":40,"_69":21,"_173":174,"_70":24,"_175":-5,"_216":259,"_17":260},{"_33":250,"_13":251,"_66":252,"_43":169,"_35":36,"_170":253,"_171":94,"_37":254,"_39":40,"_69":225,"_173":255,"_70":24,"_175":-5,"_216":256,"_17":257},{"_33":242,"_13":243,"_66":244,"_43":169,"_35":36,"_170":245,"_171":94,"_37":246,"_39":40,"_69":21,"_173":247,"_70":24,"_175":-5,"_216":248,"_17":249},{"_33":237,"_13":229,"_66":222,"_43":-5,"_35":36,"_170":40,"_171":94,"_37":238,"_39":26,"_69":239,"_173":-5,"_70":24,"_175":-5,"_216":240,"_17":241},{"_33":230,"_13":211,"_66":231,"_43":222,"_35":36,"_170":232,"_171":94,"_37":233,"_39":40,"_69":21,"_173":234,"_70":24,"_175":-5,"_216":235,"_17":236},{"_33":219,"_13":220,"_66":221,"_43":222,"_35":36,"_170":223,"_171":94,"_37":224,"_39":40,"_69":225,"_173":226,"_70":24,"_175":-5,"_216":227,"_17":228},{"_33":210,"_13":211,"_66":212,"_43":-5,"_35":36,"_170":213,"_171":94,"_37":214,"_39":40,"_69":21,"_173":215,"_70":24,"_175":-5,"_216":217,"_17":218},"823e2a02-5acb-11f0-a5a1-f69ea79377d9","README.md","72a1cd46-1e2a-406a-bb0f-ee8d802a3015",12,["D",1751849055834],"# 4x4 Grid Visual Editor\n\nA simple visual editor for creating and managing black and white 4x4 grids. Built with React, Hono, and Val Town.\n\n## Features\n\n- **Visual Grid Editor**: Click cells to toggle between black and white\n- **Text Representation**: Automatically generates a textual representation showing black cell indices and white cell count\n- **Save Functionality**: Save grids to persistent storage (grids can only be saved once)\n- **Saved Grids View**: Browse all previously saved grids in a read-only format\n- **Copy to Clipboard**: Easy copying of text representations\n\n## Project Structure\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\n## Storage\n\nUses Val Town's blob storage to persist saved grids. The storage key `savedGrids` contains an array of all saved grid objects.\n\nYou can click into each of those folders to view their respective READMEs.","children",[],[211],"25501d96-5acb-11f0-9852-f69ea79377d9","utils.ts","06089187-989a-4643-9050-c61f57b0d0b3","f904af22-e8b6-4a9e-bc0a-aec6a5114ecd",2,["D",1751848899918],"script","export interface Grid {\n id: string;\n cells: boolean[]; // 16 cells for 4x4 grid, true = black, false = white\n timestamp: string;\n saved: boolean;\n}\n\nexport const GRID_SIZE = 4;\nexport const TOTAL_CELLS = GRID_SIZE * GRID_SIZE;\n\n// Convert grid to textual representation\nexport function gridToText(cells: boolean[]): string {\n const blackIndices = cells\n .map((isBlack, index) => isBlack ? index : -1)\n .filter(index => index !== -1);\n \n const whiteCount = cells.filter(cell => !cell).length;\n \n return `[${blackIndices.join(', ')}], // ${whiteCount} white cells`;\n}\n\n// Create empty grid (all white)\nexport function createEmptyGrid(): boolean[] {\n return new Array(TOTAL_CELLS).fill(false);\n}",[],[229,220],"shared","bc6defaa-5acb-11f0-bf26-f69ea79377d9","ba9804d2-fdc3-4c3b-b012-94f1a95a19bb",16,["D",1751849153408],"# Shared\n\nThis folder contains 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 recommend `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.\n\n## Grid Types and Utilities\n\nThis folder contains:\n\n- `Grid` interface: TypeScript type for grid objects\n- `GRID_SIZE` and `TOTAL_CELLS` constants\n- `gridToText()`: Converts grid state to textual representation\n- `createEmptyGrid()`: Creates a new empty (all white) grid\n\nThese utilities are used by both the frontend React components and the backend API handlers.",[],[229,211],"040d9aaa-5acb-11f0-a3bc-f69ea79377d9",["D",1751848844056],"directory",[207,208],[229],"73222c8a-5acb-11f0-9d4a-f69ea79377d9","style.css","ab2c22a7-2510-441a-9cee-fec37b60c610",10,["D",1751849030478],"body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;\n max-width: 800px;\n margin: 0 auto;\n padding: 20px;\n background-color: #f4f4f4;\n}\n\n.grid-app {\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.tabs {\n display: flex;\n margin-bottom: 20px;\n border-bottom: 2px solid #eee;\n}\n\n.tab {\n padding: 10px 20px;\n background: none;\n border: none;\n cursor: pointer;\n font-size: 16px;\n color: #666;\n border-bottom: 2px solid transparent;\n transition: all 0.2s;\n}\n\n.tab:hover {\n color: #333;\n background-color: #f8f9fa;\n}\n\n.tab.active {\n color: #007bff;\n border-bottom-color: #007bff;\n}\n\n.grid-container {\n display: flex;\n justify-content: center;\n margin: 20px 0;\n}\n\n.grid {\n display: grid;\n grid-template-columns: repeat(4, 1fr);\n gap: 2px;\n background-color: #333;\n padding: 2px;\n border-radius: 4px;\n width: 200px;\n height: 200px;\n}\n\n.cell {\n background-color: white;\n cursor: pointer;\n transition: all 0.1s;\n border-radius: 2px;\n}\n\n.cell:hover:not(.readonly) {\n transform: scale(0.95);\n}\n\n.cell.black {\n background-color: #333;\n}\n\n.cell.white {\n background-color: white;\n}\n\n.cell.readonly {\n cursor: default;\n}\n\n.cell.readonly:hover {\n transform: none;\n}\n\n.controls {\n display: flex;\n justify-content: center;\n gap: 10px;\n margin: 20px 0;\n}\n\n.reset-btn, .save-btn, .copy-btn {\n padding: 10px 20px;\n border: none;\n border-radius: 4px;\n cursor: pointer;\n font-size: 14px;\n transition: all 0.2s;\n}\n\n.reset-btn {\n background-color: #6c757d;\n color: white;\n}\n\n.reset-btn:hover:not(:disabled) {\n background-color: #5a6268;\n}\n\n.save-btn {\n background-color: #28a745;\n color: white;\n}\n\n.save-btn:hover:not(:disabled) {\n background-color: #218838;\n}\n\n.save-btn:disabled {\n background-color: #6c757d;\n cursor: not-allowed;\n}\n\n.copy-btn {\n background-color: #007bff;\n color: white;\n font-size: 12px;\n padding: 5px 10px;\n}\n\n.copy-btn:hover {\n background-color: #0056b3;\n}\n\n.text-output {\n background-color: #f8f9fa;\n border-radius: 4px;\n padding: 15px;\n margin: 20px 0;\n}\n\n.text-output h3 {\n margin: 0 0 10px 0;\n font-size: 16px;\n color: #333;\n}\n\n.grid-text {\n background-color: #e9ecef;\n padding: 8px 12px;\n border-radius: 4px;\n font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;\n font-size: 14px;\n display: block;\n margin-bottom: 10px;\n word-break: break-all;\n}\n\n.saved-notice {\n background-color: #d4edda;\n color: #155724;\n padding: 10px;\n border-radius: 4px;\n text-align: center;\n margin-top: 20px;\n}\n\n.saved-grids-empty {\n text-align: center;\n color: #666;\n padding: 40px 20px;\n}\n\n.grids-list {\n display: grid;\n gap: 20px;\n}\n\n.saved-grid-item {\n background-color: #f8f9fa;\n border-radius: 8px;\n padding: 15px;\n border: 1px solid #e9ecef;\n}\n\n.grid-header {\n margin-bottom: 10px;\n}\n\n.grid-header small {\n color: #666;\n font-size: 12px;\n}\n\nfooter {\n text-align: center;\n margin-top: 30px;\n padding-top: 20px;\n border-top: 1px solid #eee;\n}\n\n@media (max-width: 600px) {\n body {\n padding: 10px;\n }\n \n .grid {\n width: 160px;\n height: 160px;\n }\n \n .controls {\n flex-direction: column;\n align-items: center;\n }\n}",[],[177,243],"5f285c36-5acb-11f0-922c-f69ea79377d9","index.tsx","85ca7a11-9cab-47d3-88e8-a930471c0d5d",9,["D",1751848996975],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { type Grid } 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 savedGrids?: Grid[];\n thisProjectURL?: string;\n };\n }\n}\n\ncreateRoot(root).render();",[],[177,251],["D",1751848938236],[],[177,68],"040d8fe2-5acb-11f0-a3bc-f69ea79377d9","favicon.svg","ebf5fedc-7cbe-4f04-bd86-069b166e11fb",["D",1751848844056],"",[],[177,262],"b2f8eaec-5acb-11f0-9758-f69ea79377d9","246aef39-75c5-42bb-b778-7be36e72c312",15,["D",1751849137589],"# Frontend\n\nThis is a client-side React app for the 4x4 Grid Visual Editor.\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 because 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 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 contains the React components:\n\n- `App.tsx` - Main app component with tab navigation\n- `GridEditor.tsx` - Interactive 4x4 grid editor with save functionality\n- `SavedGridsView.tsx` - Read-only view of all saved grids\n\n## Features\n\n- **Interactive Grid**: Click cells to toggle between black and white\n- **Real-time Text Output**: Shows the textual representation as you edit\n- **Save Once**: Grids can only be saved once to prevent duplicates\n- **Copy to Clipboard**: Easy copying of text representations\n- **Responsive Design**: Works on mobile and desktop",[],[177,211],"587fdaa8-5acb-11f0-8c87-f69ea79377d9","SavedGridsView.tsx","587fdb66-5acb-11f0-8c87-f69ea79377d9","f72c8ed8-c3ba-4723-955f-b9d23f7104ca",8,["D",1751848985802],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { type Grid, GRID_SIZE, gridToText } from \"../../shared/utils.ts\";\n\ninterface SavedGridsViewProps {\n grids: Grid[];\n}\n\nexport function SavedGridsView({ grids }: SavedGridsViewProps) {\n if (grids.length === 0) {\n return (\n

No saved grids yet. Create and save a grid in the Editor tab!

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

Saved Grids ({grids.length})

\n {grids.map((grid) => (\n \n ))}\n

\n );\n}\n\nfunction SavedGridItem({ grid }: { grid: Grid }) {\n const formattedDate = new Date(grid.timestamp).toLocaleString();\n const textRepresentation = gridToText(grid.cells);\n\n return (\n

\n Saved: {formattedDate}\n

\n \n

\n {grid.cells.map((isBlack, index) => (\n \n ))}\n

\n\n

\n {textRepresentation}\n \n

\n );\n}",[],[177,284,276],"components","50062256-5acb-11f0-ba5c-f69ea79377d9","GridEditor.tsx","50062346-5acb-11f0-ba5c-f69ea79377d9",7,["D",1751848971585],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { type Grid, GRID_SIZE, createEmptyGrid, gridToText } from \"../../shared/utils.ts\";\n\ninterface GridEditorProps {\n onGridSaved: () => void;\n}\n\nexport function GridEditor({ onGridSaved }: GridEditorProps) {\n const [cells, setCells] = React.useState(createEmptyGrid());\n const [gridId] = React.useState(() => crypto.randomUUID());\n const [isSaved, setIsSaved] = React.useState(false);\n const [isSaving, setIsSaving] = React.useState(false);\n\n const toggleCell = (index: number) => {\n if (isSaved) return; // Don't allow editing saved grids\n \n setCells(prev => {\n const newCells = [...prev];\n newCells[index] = !newCells[index];\n return newCells;\n });\n };\n\n const resetGrid = () => {\n if (isSaved) return;\n setCells(createEmptyGrid());\n };\n\n const saveGrid = async () => {\n if (isSaved || isSaving) return;\n\n setIsSaving(true);\n try {\n const grid: Grid = {\n id: gridId,\n cells,\n timestamp: new Date().toISOString(),\n saved: false\n };\n\n const response = await fetch(\"/grids\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(grid),\n });\n\n if (response.ok) {\n setIsSaved(true);\n onGridSaved();\n } else {\n const error = await response.json();\n alert(`Failed to save grid: ${error.error}`);\n }\n } catch (error) {\n console.error(\"Failed to save grid\", error);\n alert(\"Failed to save grid\");\n } finally {\n setIsSaving(false);\n }\n };\n\n const textRepresentation = gridToText(cells);\n\n return (\n

\n {cells.map((isBlack, index) => (\n toggleCell(index)}\n title={`Cell ${index} - Click to ${isBlack ? 'make white' : 'make black'}`}\n />\n ))}\n

\n\n

\n \n \n

\n\n

Text Representation:

\n {textRepresentation}\n \n

\n\n {isSaved && (\n

\n ✅ Grid saved! This grid can no longer be edited.\n

\n )}\n

\n );\n}",[],[177,284,286],"469a7d70-5acb-11f0-8d6d-f69ea79377d9","App.tsx","c51574f8-fdb9-460a-91fa-36e75158900c",6,["D",1751848955763],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { type Grid, GRID_SIZE, createEmptyGrid, gridToText } from \"../../shared/utils.ts\";\nimport { GridEditor } from \"./GridEditor.tsx\";\nimport { SavedGridsView } from \"./SavedGridsView.tsx\";\n\nexport function App(\n { savedGrids = [], thisProjectURL }: { savedGrids?: Grid[]; thisProjectURL?: string },\n) {\n const [currentTab, setCurrentTab] = React.useState<'editor' | 'saved'>('editor');\n const [grids, setGrids] = React.useState(savedGrids);\n\n const fetchSavedGrids = async () => {\n try {\n const response = await fetch(\"/grids\");\n const data = await response.json();\n setGrids(data);\n } catch (error) {\n console.error(\"Failed to fetch saved grids\", error);\n }\n };\n\n return (\n

🎨 4x4 Grid Editor

\n \n

\n \n \n

\n\n

\n {currentTab === 'editor' ? (\n \n ) : (\n \n )}\n

\n\n {thisProjectURL && (\n \n )}\n

\n );\n}",[],[177,284,294],"040d8aba-5acb-11f0-a3bc-f69ea79377d9",["D",1751848844056],[198,199,200],[177,284],"040d9668-5acb-11f0-a3bc-f69ea79377d9",["D",1751848844056],[197,201,202,203,204,205],[177],"394e49d0-5acb-11f0-a8e1-f69ea79377d9","index.ts","f7a1ab55-c2ca-4b4f-a54f-ec57c03ce174","93514baf-b2a6-4f97-b1b5-0a071667f576",4,["D",1751848933465],"http","import { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { getSavedGrids, saveGrid } 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 saved grids data into index.html\n // To avoid an extra request and loading flash\n const savedGrids = await getSavedGrids();\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 => serveFile(c.req.path.replace(\"/public\", \"/frontend\"), import.meta.url));\n\n// Serve all /shared files under /shared\napp.get(\"/shared/**/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Provide an endpoint for the frontend to get saved grids as JSON\napp.get(\"/grids\", async (c) => {\n const grids = await getSavedGrids();\n return c.json(grids);\n});\n\n// Provide an endpoint for the frontend to save a new grid\napp.post(\"/grids\", async (c) => {\n try {\n const grid = await c.req.json();\n\n if (!grid || !grid.id || !Array.isArray(grid.cells) || grid.cells.length !== 16) {\n return c.json({ error: \"Invalid grid data\" }, 400);\n }\n\n await saveGrid(grid);\n return c.json({ success: true }, 201);\n } catch (error) {\n if (error.message === \"Grid has already been saved\") {\n return c.json({ error: error.message }, 409);\n }\n throw error;\n }\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;",[],[319,310],"backend","2ee5040c-cc81-11f0-90e6-42dde27851f2","getgrids.ts",["D",1764351565800],17,"import { getSavedGrids } from \"./database/queries.ts\";\nimport { blob } from \"https://esm.town/v/std/blob\";\n\n\n\nconst savedGrids = await blob.getJSON(\"savedGrids\");\n\n const gridWhitesCount = grid => grid.cells.filter(x => x === false).length;\n const templateA = savedGrids.filter(x => gridWhitesCount(x) === 10)[0]\n\n\n\n\nexport default async function(request: Request) {\n return new Response(JSON.stringify(savedGrids))\n}",[],[319,321],"9c7be148-5acb-11f0-8a2d-f69ea79377d9","9d4b149e-2007-4d2e-bae8-882b807d1e36",13,["D",1751849099864],"# Backend\n\nThis folder contains all backend-only code in this project. It's broken up into:\n\n* `index.ts` - this is the **entrypoint** for this whole project\n* `database/` - this contains the code for interfacing with Val Town's blob storage\n\n## Hono\n\nThis app uses [Hono](https://hono.dev/) as the API framework. You can think of Hono as a replacement for [ExpressJS](https://expressjs.com/) that works in serverless environments like Val Town or Cloudflare Workers. If you come from Python or Ruby, Hono is also a lot like [Flask](https://github.com/pallets/flask) or [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 browser to render the app, including HTML, JavaScript (including all client-side React), CSS, and even the favicon SVG.\n\nIn a normal server environment, you would likely use a middleware [like this one](https://hono.dev/docs/getting-started/nodejs#serve-static-files) to serve static files. Some frameworks or deployment platforms automatically make any content inside a `public/` folder public. \n\nHowever in Val Town you need to handle this yourself, and it can be suprisingly difficult to read and serve files in a Val Town Project. This template uses helper functions from [stevekrouse/utils/serve-public](https://www.val.town/x/stevekrouse/utils/branch/main/code/serve-public/README.md), which handle reading project files in a way that will work across branches and forks, automatically transpiles typescript to javascript, and assigns content-types based on the file's extension.\n\n### `index.html`\n\nThe most complicated part of this backend API is serving index.html. In this app (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 gets dynamically injected JSON data without having to make another round-trip request to the server to get that data on the frontend. This is a common pattern for client-side rendered apps.\n\n## CRUD API Routes\n\nThis app has two CRUD API routes: for reading and saving grids. They both speak JSON, which is standard. They import their functions from `/backend/database/queries.ts`. These routes are called from the React app to refresh and update data.\n\n## Storage\n\nInstead of SQLite, this app uses Val Town's blob storage to persist saved grids. This is simpler for this use case and doesn't require database migrations.\n\n## Errors\n\nHono and other API frameworks have a habit of swallowing up Errors. We turn off this default behavior by re-throwing errors, because we think most of the time you'll want to see the full stack trace instead of merely \"Internal Server Error\". You can customize how you want errors to appear.",[],[319,211],"c9c1e526-5acb-11f0-9822-f69ea79377d9","queries.ts","5979949f-2d7b-42aa-9829-74919ef30921","142351da-8260-45dc-a2c9-87d1b7c3f07c",["D",1751849175816],"import { blob } from \"https://esm.town/v/std/blob\";\nimport { type Grid } from \"../../shared/utils.ts\";\n\nconst SAVED_GRIDS_KEY = \"savedGrids\";\n\nexport async function getSavedGrids(): Promise {\n try {\n const savedGrids = await blob.getJSON(SAVED_GRIDS_KEY);\n \n // Handle legacy format or empty case\n if (!savedGrids) {\n return [];\n }\n \n // If it's already an array, return it\n if (Array.isArray(savedGrids)) {\n return savedGrids;\n }\n \n // If it's the old object format, convert it to new array format\n if (typeof savedGrids === 'object') {\n const convertedGrids: Grid[] = [];\n for (const [key, value] of Object.entries(savedGrids)) {\n if (value && typeof value === 'object' && 'gridState' in value) {\n const legacyGrid = value as any;\n convertedGrids.push({\n id: crypto.randomUUID(),\n cells: legacyGrid.gridState || new Array(16).fill(false),\n timestamp: legacyGrid.savedAt || new Date().toISOString(),\n saved: true\n });\n }\n }\n \n // Save the converted format back to blob storage\n if (convertedGrids.length > 0) {\n await blob.setJSON(SAVED_GRIDS_KEY, convertedGrids);\n }\n \n return convertedGrids;\n }\n \n return [];\n } catch (error) {\n // If the key doesn't exist, return empty array\n return [];\n }\n}\n\nexport async function saveGrid(grid: Grid): Promise {\n const savedGrids = await getSavedGrids();\n \n // Check if grid is already saved\n const existingGrid = savedGrids.find(g => g.id === grid.id);\n if (existingGrid) {\n throw new Error(\"Grid has already been saved\");\n }\n \n // Mark as saved and add to collection\n grid.saved = true;\n savedGrids.push(grid);\n \n await blob.setJSON(SAVED_GRIDS_KEY, savedGrids);\n}",[],[319,342,335],"database","040d6f9e-5acb-11f0-a3bc-f69ea79377d9","migrations.ts","bc96213c-425e-47b2-9017-7f21e4a785bb",["D",1751848844056],"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}",[],[319,342,344],"a79c0012-5acb-11f0-8d8f-f69ea79377d9","8c137ceb-1bb6-4ce3-af63-d421f501e864",14,["D",1751849118526],"# Database\n\nThis app uses [Val Town Blob Storage](https://docs.val.town/std/blob/) to manage data. Every Val Town account comes with free blob storage for simple key-value data persistence. This folder contains:\n\n* `queries.ts` - functions to read and write grid data to blob storage, which are imported and used in the main Hono server in `/backend/index.ts`\n\n## Storage Strategy\n\nInstead of using SQLite, this app uses blob storage because:\n- Simpler for this use case (no complex relationships)\n- No need for database migrations\n- Easy JSON serialization/deserialization\n- Perfect for storing arrays of grid objects\n\n## Data Structure\n\nThe app stores a single blob with the key `savedGrids` containing an array of Grid objects. Each grid has:\n- `id`: unique identifier\n- `cells`: array of 16 booleans representing the 4x4 grid state\n- `timestamp`: when the grid was created\n- `saved`: whether the grid has been saved (prevents duplicate saves)\n\n## Queries\n\nThe queries file exports functions to:\n- `getSavedGrids()`: Retrieve all saved grids from blob storage\n- `saveGrid(grid)`: Add a new grid to the saved collection (with duplicate prevention)\n\nThe functions handle cases where the blob doesn't exist yet and provide proper error handling for duplicate saves.",[],[319,342,211],"040d7480-5acb-11f0-a3bc-f69ea79377d9",["D",1751848844056],[190,191,192],[319,342],"040d85ec-5acb-11f0-a3bc-f69ea79377d9",["D",1751848844056],[189,193,194,195],[319],["D",1751848844056],{"_11":12,"_134":73},{"_11":12,"_129":130,"_72":73,"_30":71,"_131":132,"_133":24},{"_39":117,"_13":16,"_33":36,"_118":83,"_119":63,"_120":121,"_122":87,"_123":124,"_125":126,"_127":14,"_128":12},"ctx",{"_52":-5,"_155":402,"_403":404,"_405":406,"_407":24,"_408":24,"_409":24,"_410":94,"_411":-5,"_412":-7,"_413":-7,"_414":26,"_415":24,"_416":24,"_417":-5,"_418":24,"_419":24,"_420":24,"_421":-5},"ENV",{"_373":374,"_375":376,"_377":16,"_378":379,"_380":381,"_382":383,"_384":385,"_386":387,"_388":389,"_390":391,"_392":393,"_394":395,"_396":397,"_398":399,"_400":401},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","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 · index.html