\n \n \n",[18,156],"2266ed6c-044a-11f0-bd10-569c3dd06744","components","6a490526-b11f-45f0-85a5-3a7c54693dac",["D",1742337689937],[18,162],"pulls","branches","forks","envVars",{"_173":26,"_175":26},"connections",{"_173":26,"_174":26},"count","unfilledCount","emptyCount",{"_38":223,"_13":222,"_32":216,"_136":-5,"_137":80,"_138":139,"_140":24,"_40":224,"_78":26,"_34":35,"_142":-5,"_36":30,"_143":-5,"_191":225,"_17":226},{"_38":214,"_13":215,"_32":51,"_136":216,"_137":80,"_138":139,"_140":24,"_40":217,"_78":26,"_34":218,"_142":219,"_36":30,"_143":-5,"_191":220,"_17":221},{"_38":135,"_13":18,"_32":33,"_136":-5,"_137":80,"_138":139,"_140":24,"_40":211,"_78":26,"_34":35,"_142":-5,"_36":30,"_143":-5,"_191":212,"_17":213},{"_38":161,"_13":162,"_32":163,"_136":33,"_137":80,"_138":139,"_140":24,"_40":208,"_78":26,"_34":35,"_142":-5,"_36":30,"_143":-5,"_191":209,"_17":210},{"_38":200,"_13":201,"_32":202,"_136":163,"_137":80,"_138":79,"_140":24,"_40":203,"_78":204,"_34":152,"_142":205,"_36":30,"_143":-5,"_191":206,"_17":207},{"_38":155,"_13":156,"_32":157,"_136":33,"_137":80,"_138":139,"_140":24,"_40":197,"_78":26,"_34":21,"_142":159,"_36":30,"_143":-5,"_191":198,"_17":199},{"_38":148,"_13":149,"_32":150,"_136":33,"_137":80,"_138":139,"_140":24,"_40":194,"_78":26,"_34":152,"_142":153,"_36":30,"_143":-5,"_191":195,"_17":196},{"_38":184,"_13":185,"_32":186,"_136":-5,"_137":80,"_138":187,"_140":24,"_40":188,"_78":189,"_34":21,"_142":190,"_36":30,"_143":-5,"_191":192,"_17":193},"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",[],[185],["D",1742337689937],[],[18,149],["D",1742337689937],[],[18,156],"0009912e-044b-11f0-bcab-569c3dd06744","App.tsx","50bb7fe0-b78e-4ec8-ada2-d1e26b0b6229",["D",1742338061808],12,"/** @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;",[],[18,162,201],["D",1742337689937],[180],[18,162],["D",1742337689937],[179,181,182],[18],"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;",[],[222,215],"backend","2266e2cc-044a-11f0-bd10-569c3dd06744",["D",1742337689937],[177],[222],["D",1742337689937],{"_11":12,"_100":95},{"_11":12,"_93":-5,"_94":95,"_31":96,"_97":98,"_99":30},{"_78":79,"_13":16,"_38":80,"_81":39,"_82":83,"_84":85,"_86":45,"_87":88,"_89":90,"_91":14,"_92":12},"ctx",{"_71":-5,"_121":264,"_265":266,"_267":268,"_269":30,"_270":30,"_271":30,"_272":24,"_273":-5,"_274":-7,"_275":-7,"_276":26,"_277":30,"_278":30,"_279":-5,"_280":30,"_281":30,"_282":30,"_283":-5},"ENV",{"_235":236,"_237":238,"_239":16,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261,"_262":263},"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 · frontend