\n \n \n","label",[164,62],"frontend","pulls","branches","forks","envVars",{"_172":26,"_174":26},"connections",{"_172":26,"_173":26},"count","unfilledCount","emptyCount",{"_32":237,"_13":236,"_60":230,"_42":-5,"_34":35,"_157":39,"_158":81,"_36":238,"_38":26,"_63":221,"_160":-5,"_64":24,"_162":-5,"_190":239,"_17":240},{"_32":228,"_13":229,"_60":79,"_42":230,"_34":35,"_157":39,"_158":81,"_36":231,"_38":26,"_63":232,"_160":233,"_64":24,"_162":-5,"_190":234,"_17":235},{"_32":224,"_13":164,"_60":156,"_42":-5,"_34":35,"_157":39,"_158":81,"_36":225,"_38":26,"_63":221,"_160":-5,"_64":24,"_162":-5,"_190":226,"_17":227},{"_32":219,"_13":218,"_60":213,"_42":156,"_34":35,"_157":39,"_158":81,"_36":220,"_38":26,"_63":221,"_160":-5,"_64":24,"_162":-5,"_190":222,"_17":223},{"_32":210,"_13":211,"_60":212,"_42":213,"_34":35,"_157":39,"_158":81,"_36":214,"_38":26,"_63":188,"_160":215,"_64":24,"_162":-5,"_190":216,"_17":217},{"_32":155,"_13":62,"_60":61,"_42":156,"_34":35,"_157":39,"_158":81,"_36":207,"_38":26,"_63":21,"_160":161,"_64":24,"_162":-5,"_190":208,"_17":209},{"_32":200,"_13":201,"_60":202,"_42":156,"_34":35,"_157":39,"_158":81,"_36":203,"_38":26,"_63":188,"_160":204,"_64":24,"_162":-5,"_190":205,"_17":206},{"_32":193,"_13":194,"_60":195,"_42":-5,"_34":35,"_157":39,"_158":81,"_36":196,"_38":26,"_63":21,"_160":197,"_64":24,"_162":-5,"_190":198,"_17":199},{"_32":184,"_13":185,"_60":186,"_42":-5,"_34":35,"_157":104,"_158":81,"_36":187,"_38":26,"_63":188,"_160":189,"_64":24,"_162":-5,"_190":191,"_17":192},"e75dfb58-7608-11f0-8d59-0224a6c84d84","new-file-7775.tsx","e75dfc2a-7608-11f0-8d59-0224a6c84d84",["D",1754844106191],"script","","children",[],[185],"e2420ae2-7608-11f0-a77a-0224a6c84d84","README.md","019894db-ec50-703f-855b-235a2aff8ee7",["D",1754844097514],"# 🍴 Forky\n\nA simple web application that allows you to fork Val Town projects with a clean user interface.\n\n## Overview\n\nForky is a utility that enables you to create copies (forks) of any public Val Town project. It provides a straightforward interface where you can enter a Val Town project URL and your API token to create your own copy of the project.\n\n## Features\n\n- Fork any public Val Town project with a single click\n- Preserves the entire project structure, including all files and directories\n- Maintains project metadata (descriptions, images, etc.)\n- Clean, responsive UI built with React and TailwindCSS\n\n## Prerequisites\n\n- A [Val Town](https://www.val.town) account\n- A Val Town API token with project read and write permissions\n\n## Usage\n\n1. Enter the URL of the Val Town project you want to fork (format: `https://www.val.town/x/username/projectname`)\n2. Enter your Val Town API token with the proper `project:write` permissions\n3. Click \"Fork\" and wait for the process to complete\n4. Once successful, you'll have a new copy of the project in your Val Town account under a new generated name\n\n## Project Structure\n\n```\n├── backend\n│ └── index.ts # Backend server and API endpoints\n├── frontend\n│ ├── components\n│ │ └── App.tsx # Main React component\n│ ├── index.html # HTML entry point\n│ └── index.tsx # Frontend JavaScript entry point\n└── README.md # This file\n```\n\n## How It Works\n\nForky uses the Val Town SDK to:\n\n1. Retrieve information about the source project\n2. Create a new project in your account\n3. Copy all files from the source project to your new project\n4. Preserve the project structure and metadata\n\n## API\n\nThe application exposes the following API endpoint:\n\n- `POST /fork?url={encoded-url}` - Forks the specified project\n - Requires an `Authorization` header with a `Bearer` token\n - Returns a JSON response with success or error information",[],[194],"e24208bc-7608-11f0-a77a-0224a6c84d84","index.tsx","019894db-ec50-703f-855b-1a2ef3cd200d",["D",1754844097514],"/** @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();",[],[164,201],["D",1754844097514],[],[164,62],"e24201b4-7608-11f0-a77a-0224a6c84d84","App.tsx","019894db-ec4f-76e8-976e-ea3baba9c5b3","019894db-ec50-703f-855b-111d7bd1b2d2",["D",1754844097514],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\n\nexport function App() {\n const [projectUrl, setProjectUrl] = useState(\"\");\n const [apiToken, setApiToken] = useState(\"\");\n const [loading, setLoading] = useState(false);\n const [message, setMessage] = useState(\"\");\n const [error, setError] = useState(\"\");\n\n const handleFork = async (e) => {\n e.preventDefault();\n setLoading(true);\n setMessage(\"\");\n setError(\"\");\n\n try {\n // Simple validation\n if (!projectUrl.trim()) {\n throw new Error(\"Please enter a valid project URL\");\n }\n\n if (!apiToken.trim()) {\n throw new Error(\"API Token is required\");\n }\n\n const response = await fetch(`/fork?url=${encodeURIComponent(projectUrl)}`, {\n method: \"POST\",\n headers: {\n \"Authorization\": `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n const errorData = await response.json();\n throw new Error(errorData.message || \"Failed to fork the project\");\n }\n\n const result = await response.json();\n console.log(result);\n\n setMessage(`Successfully forked project: ${result}!`);\n } catch (err) {\n setError(err.message || \"An error occurred while forking the project\");\n } finally {\n setLoading(false);\n }\n };\n\n return (\n

Fork Fork Fork Fork IT

\n Forky willy generate a clone of this project in your account with a _timestamp suffix to ensure there aren't\n any name conflicts.\n

\n \n Project URL\n \n setProjectUrl(e.target.value)}\n placeholder=\"https://www.val.town/x/shouser/forky\"\n className=\"w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-2 focus:ring-purple-500\"\n />\n

\n\n

\n \n \n Val Town API Token\n {\" \"}\n (with project:write permissions)\n \n setApiToken(e.target.value)}\n placeholder=\"vtwn_*********\"\n className=\"w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-2 focus:ring-purple-500\"\n />\n

\n\n \n {loading ? \"Forking...\" : \"Fork\"}\n \n \n\n {message && (\n

\n {message}\n

\n )}\n\n {error && (\n

\n {error}\n

\n )}\n

\n );\n}\n\nexport default App;",[],[164,218,211],"components","e242068c-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],"directory",[179],[164,218],"e24209c0-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[178,180,181],[164],"e241ea08-7608-11f0-a77a-0224a6c84d84","index.ts","019894db-ec4f-76e8-976e-e43b8644b6ae",["D",1754844097514],"http","import { listFiles } from \"https://esm.town/v/std/utils/index.ts\";\nimport { parseProject, serveFile } from \"https://esm.town/v/std/utils@64-main/index.ts\";\nimport ValTown from \"npm:@valtown/sdk\";\nimport { Hono } from \"npm:hono\";\n\nconst app = new Hono();\n\n// Serve index.html at the root /\napp.get(\"/\", async c => {\n return serveFile(\"/frontend/index.html\", import.meta.url);\n});\n\napp.post(\"/fork\", async c => {\n try {\n const projectUrl = c.req.query(\"url\");\n const authHeader = c.req.header(\"Authorization\");\n\n let authToken = null;\n if (authHeader && authHeader.startsWith(\"Bearer \")) {\n authToken = authHeader.substring(7);\n }\n\n if (!projectUrl || !authToken) {\n return c.json({\n success: false,\n error: \"Missing required parameter: url or auth token\",\n }, 400);\n }\n\n const authenticatedVt = new ValTown({\n bearerToken: authToken,\n });\n\n const { username, projectName } = parseValTownProjectURL(projectUrl);\n\n if (!username || !projectName) {\n return c.json({\n success: false,\n error: \"Missing required parameters: username and projectName\",\n }, 400);\n }\n\n let projectDetails;\n try {\n projectDetails = await authenticatedVt.alias.username.projectName.retrieve(username, projectName);\n console.log(\"Project details retrieved:\", projectDetails);\n } catch (error) {\n console.error(\"Error retrieving project details:\", error);\n return c.json({\n success: false,\n error: `Error retrieving project details: ${error.message || error}`,\n status: error.status,\n statusText: error.statusText,\n }, 400);\n }\n\n if (!projectDetails || !projectDetails.id) {\n return c.json({\n success: false,\n error: \"Project not found\",\n }, 404);\n }\n\n const projectId = projectDetails.id;\n let newProject;\n try {\n newProject = await authenticatedVt.projects.create({\n privacy: \"public\",\n name: `${projectDetails.name}_${Date.now().toString()}`,\n description: projectDetails.description ?? undefined,\n imageUrl: projectDetails.imageUrl ?? undefined,\n });\n console.log(\"New project created:\", newProject);\n } catch (error) {\n console.error(\"Error creating project:\", error);\n return c.json({\n success: false,\n error: `Error creating project: ${error.message || error}`,\n status: error.status,\n statusText: error.statusText,\n }, 400);\n }\n\n console.log(\"Listing files\");\n let files;\n try {\n files = await authenticatedVt.projects.files.list(projectId, { recursive: true });\n console.log(\"Files listed:\", files.body.data.length);\n } catch (error) {\n console.error(\"Error listing files:\", error);\n return c.json({\n success: false,\n error: `Error listing files: ${error.message || error}`,\n }, 400);\n }\n\n console.log(\"Getting files with content\");\n try {\n const newFiles = await getFilesWithContent(authenticatedVt, files.body.data, projectId, newProject.id);\n console.log(\"Files copied:\", newFiles.length);\n } catch (error) {\n console.error(\"Error copying files:\", error);\n return c.json({\n success: false,\n error: `Error copying files: ${error.message || error}`,\n }, 400);\n }\n\n return c.json({\n success: true,\n newProject: newProject,\n }, 200);\n } catch (error) {\n console.error(\"Unexpected error:\", error);\n return c.json({\n success: false,\n error: `Unexpected error: ${error.message || error}`,\n stack: error.stack,\n }, 500);\n }\n});\n\nfunction parseValTownProjectURL(url) {\n // Use the URL constructor to parse the URL\n const { pathname } = new URL(url);\n // Split the pathname and filter out empty segments\n const parts = pathname.split(\"/\").filter(Boolean);\n // Expecting the format: [\"x\", \"stevekrouse\", \"getProjectsAsZips\"]\n if (parts.length < 3 || parts[0] !== \"x\") {\n throw new Error(\"Invalid URL structure\");\n }\n const username = parts[1];\n const projectName = parts[2];\n return { username, projectName };\n}\n\nasync function getFilesWithContent(authenticatedVT, files, projectId, newProjectId) {\n console.log(\"files:\", files);\n const nonDirectoryFiles = files.filter(file => file.type !== \"directory\");\n console.log(`Processing ${nonDirectoryFiles.length} non-directory files`);\n\n const failedFiles = [];\n const successfulFiles = [];\n\n for (const file of nonDirectoryFiles) {\n try {\n const urlEncodedPath = encodeURIComponent(file.path);\n console.log(`Processing file: ${file.path} (encoded: ${urlEncodedPath})`);\n\n console.log(`Getting content for file: ${file.path}`);\n const responseContent = await authenticatedVT.projects.files.getContent(projectId, urlEncodedPath);\n\n if (!responseContent) {\n throw new Error(`Could not get content for file: ${file.path}`);\n }\n\n const textContent = await responseContent.text();\n console.log(`Content retrieved for ${file.path} (${textContent.length} bytes)`);\n\n console.log(`Creating file in new project: ${file.path}`);\n const responseCreation = await authenticatedVT.projects.files.create(newProjectId, urlEncodedPath, {\n content: textContent,\n type: file.type,\n });\n\n if (!responseCreation) {\n throw new Error(`Could not create file: ${file.path}`);\n }\n\n console.log(`File created successfully: ${file.path}`);\n successfulFiles.push({\n name: file.path,\n });\n } catch (error) {\n console.error(`Error processing file ${file.path}:`, error);\n failedFiles.push({\n path: file.path,\n error: error.message || String(error),\n });\n }\n }\n\n if (failedFiles.length > 0) {\n console.error(`Failed to process ${failedFiles.length} files`);\n const failedFilesList = failedFiles.map(f => `'${f.path}': ${f.error}`).join(\", \");\n throw new Error(`Failed to process files: ${failedFilesList}`);\n }\n\n return successfulFiles;\n}\n\n// Serve all /frontend files\napp.get(\"/frontend/**/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Add your API routes here\n// app.get(\"/api/data\", c => c.json({ hello: \"world\" }));\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;",[],[236,229],"backend","e241ff84-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[176],[236],["D",1754844097514],{"_11":12,"_121":67},{"_11":12,"_117":-5,"_66":67,"_30":65,"_118":119,"_120":24},{"_38":104,"_13":16,"_32":35,"_105":69,"_106":107,"_108":109,"_110":74,"_111":112,"_113":114,"_115":14,"_116":12},"ctx",{"_50":-5,"_142":278,"_279":280,"_281":282,"_283":24,"_284":24,"_285":24,"_286":81,"_287":-5,"_288":-7,"_289":-7,"_290":26,"_291":24,"_292":24,"_293":-5,"_294":24,"_295":24,"_296":24,"_297":-5},"ENV",{"_249":250,"_251":252,"_253":16,"_254":255,"_256":257,"_258":259,"_260":261,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277},"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 · index.html