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;",[147,34,150],"pulls","branches","forks","envVars",{"_164":26,"_166":26},"connections",{"_164":26,"_165":26},"count","unfilledCount","emptyCount",{"_39":218,"_13":217,"_32":211,"_137":-5,"_139":81,"_140":141,"_142":24,"_41":219,"_79":26,"_35":36,"_144":-5,"_37":30,"_145":-5,"_182":220,"_17":221},{"_39":209,"_13":210,"_32":52,"_137":211,"_139":81,"_140":141,"_142":24,"_41":212,"_79":26,"_35":213,"_144":214,"_37":30,"_145":-5,"_182":215,"_17":216},{"_39":205,"_13":147,"_32":138,"_137":-5,"_139":81,"_140":141,"_142":24,"_41":206,"_79":26,"_35":36,"_144":-5,"_37":30,"_145":-5,"_182":207,"_17":208},{"_39":136,"_13":34,"_32":33,"_137":138,"_139":81,"_140":141,"_142":24,"_41":202,"_79":26,"_35":36,"_144":-5,"_37":30,"_145":-5,"_182":203,"_17":204},{"_39":149,"_13":150,"_32":151,"_137":33,"_139":81,"_140":80,"_142":24,"_41":199,"_79":153,"_35":154,"_144":155,"_37":30,"_145":-5,"_182":200,"_17":201},{"_39":192,"_13":193,"_32":194,"_137":138,"_139":81,"_140":141,"_142":24,"_41":195,"_79":26,"_35":21,"_144":196,"_37":30,"_145":-5,"_182":197,"_17":198},{"_39":185,"_13":186,"_32":187,"_137":138,"_139":81,"_140":141,"_142":24,"_41":188,"_79":26,"_35":154,"_144":189,"_37":30,"_145":-5,"_182":190,"_17":191},{"_39":175,"_13":176,"_32":177,"_137":-5,"_139":81,"_140":178,"_142":24,"_41":179,"_79":180,"_35":21,"_144":181,"_37":30,"_145":-5,"_182":183,"_17":184},"6810d6a2-044a-11f0-a8ed-569c3dd06744","README.md","8460dd66-420a-4c87-8b02-2f95b8d5ca9d",3,["D",1742337806841],2,"# 🍴 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","children",[],[176],"2266f208-044a-11f0-bd10-569c3dd06744","index.tsx","837bb59c-5534-43b2-be69-d17f185eaa1a",["D",1742337689937],"/** @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();",[],[147,186],"2266efa6-044a-11f0-bd10-569c3dd06744","index.html","ef1ec8c6-44e3-4c86-a0ef-9e73506ff35c",["D",1742337689937],"\n\n \n \n \n React Hono Val Town Starter\n \n \n \n \n

\n \n \n",[],[147,193],["D",1742338061808],[],[147,34,150],["D",1742337689937],[171],[147,34],"2266f44c-044a-11f0-bd10-569c3dd06744",["D",1742337689937],[170,172,173],[147],"2266b4a0-044a-11f0-bd10-569c3dd06744","index.ts","58377385-4bce-4e0c-bfab-041f8264636c",["D",1742337689937],"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;",[],[217,210],"backend","2266e2cc-044a-11f0-bd10-569c3dd06744",["D",1742337689937],[168],[217],["D",1742337689937],{"_11":12,"_101":96},{"_11":12,"_94":-5,"_95":96,"_31":97,"_98":99,"_100":30},{"_79":80,"_13":16,"_39":81,"_82":40,"_83":84,"_85":86,"_87":46,"_88":89,"_90":91,"_92":14,"_93":12},"ctx",{"_72":-5,"_122":259,"_260":261,"_262":263,"_264":30,"_265":30,"_266":30,"_267":24,"_268":-5,"_269":-7,"_270":-7,"_271":26,"_272":30,"_273":30,"_274":-5,"_275":30,"_276":30,"_277":30,"_278":-5},"ENV",{"_230":231,"_232":233,"_234":16,"_235":236,"_237":238,"_239":240,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258},"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