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;",[167,71,63],"pulls","branches","forks","envVars",{"_180":26,"_182":26},"connections",{"_180":26,"_181":26},"count","unfilledCount","emptyCount",{"_33":240,"_13":239,"_61":233,"_43":-5,"_35":36,"_161":40,"_162":24,"_37":241,"_39":26,"_64":72,"_164":-5,"_66":30,"_165":-5,"_197":242,"_17":243},{"_33":231,"_13":232,"_61":84,"_43":233,"_35":36,"_161":40,"_162":24,"_37":234,"_39":26,"_64":235,"_164":236,"_66":30,"_165":-5,"_197":237,"_17":238},{"_33":227,"_13":167,"_61":160,"_43":-5,"_35":36,"_161":40,"_162":24,"_37":228,"_39":26,"_64":72,"_164":-5,"_66":30,"_165":-5,"_197":229,"_17":230},{"_33":159,"_13":71,"_61":70,"_43":160,"_35":36,"_161":40,"_162":24,"_37":224,"_39":26,"_64":72,"_164":-5,"_66":30,"_165":-5,"_197":225,"_17":226},{"_33":169,"_13":63,"_61":62,"_43":70,"_35":36,"_161":40,"_162":24,"_37":221,"_39":26,"_64":65,"_164":171,"_66":30,"_165":-5,"_197":222,"_17":223},{"_33":214,"_13":215,"_61":216,"_43":160,"_35":36,"_161":40,"_162":24,"_37":217,"_39":26,"_64":21,"_164":218,"_66":30,"_165":-5,"_197":219,"_17":220},{"_33":207,"_13":208,"_61":209,"_43":160,"_35":36,"_161":40,"_162":24,"_37":210,"_39":26,"_64":65,"_164":211,"_66":30,"_165":-5,"_197":212,"_17":213},{"_33":200,"_13":201,"_61":202,"_43":-5,"_35":36,"_161":40,"_162":24,"_37":203,"_39":26,"_64":21,"_164":204,"_66":30,"_165":-5,"_197":205,"_17":206},{"_33":192,"_13":193,"_61":194,"_43":-5,"_35":36,"_161":108,"_162":24,"_37":195,"_39":26,"_64":65,"_164":196,"_66":30,"_165":-5,"_197":198,"_17":199},"e75dfb58-7608-11f0-8d59-0224a6c84d84","new-file-7775.tsx","e75dfc2a-7608-11f0-8d59-0224a6c84d84",["D",1754844106191],"","children",[],[193],"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",[],[201],"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();",[],[167,208],"e24207ae-7608-11f0-a77a-0224a6c84d84","index.html","019894db-ec50-703f-855b-17e401b1f135",["D",1754844097514],"\n\n \n \n \n React Hono Val Town Starter\n \n \n \n \n

\n \n \n",[],[167,215],["D",1754844097514],[],[167,71,63],["D",1754844097514],[187],[167,71],"e24209c0-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[186,188,189],[167],"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;",[],[239,232],"backend","e241ff84-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[184],[239],["D",1754844097514],{"_11":12,"_125":69},{"_11":12,"_121":-5,"_68":69,"_31":67,"_122":123,"_124":30},{"_39":108,"_13":16,"_33":36,"_109":74,"_110":111,"_112":113,"_114":79,"_115":116,"_117":118,"_119":14,"_120":12},"ctx",{"_51":-5,"_146":281,"_282":283,"_284":285,"_286":30,"_287":30,"_288":30,"_289":24,"_290":-5,"_291":-7,"_292":-7,"_293":26,"_294":30,"_295":30,"_296":-5,"_297":30,"_298":30,"_299":30,"_300":-5},"ENV",{"_252":253,"_254":255,"_256":16,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270,"_271":272,"_273":274,"_275":276,"_277":278,"_279":280},"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 · components