\n \n \n",[18,80],"e242068c-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[18,85],"pulls","branches","forks","envVars",{"_81":26,"_203":26},"connections",{"_81":26,"_202":26},"unfilledCount","emptyCount",{"_33":256,"_13":255,"_67":249,"_43":-5,"_35":36,"_175":40,"_176":24,"_37":257,"_39":26,"_70":86,"_178":-5,"_72":30,"_179":-5,"_218":258,"_17":259},{"_33":247,"_13":248,"_67":99,"_43":249,"_35":36,"_175":40,"_176":24,"_37":250,"_39":26,"_70":251,"_178":252,"_72":30,"_179":-5,"_218":253,"_17":254},{"_33":174,"_13":18,"_67":87,"_43":-5,"_35":36,"_175":40,"_176":24,"_37":244,"_39":26,"_70":86,"_178":-5,"_72":30,"_179":-5,"_218":245,"_17":246},{"_33":192,"_13":85,"_67":84,"_43":87,"_35":36,"_175":40,"_176":24,"_37":241,"_39":26,"_70":86,"_178":-5,"_72":30,"_179":-5,"_218":242,"_17":243},{"_33":234,"_13":235,"_67":236,"_43":84,"_35":36,"_175":40,"_176":24,"_37":237,"_39":26,"_70":71,"_178":238,"_72":30,"_179":-5,"_218":239,"_17":240},{"_33":188,"_13":80,"_67":79,"_43":87,"_35":36,"_175":40,"_176":24,"_37":231,"_39":26,"_70":21,"_178":190,"_72":30,"_179":-5,"_218":232,"_17":233},{"_33":184,"_13":69,"_67":68,"_43":87,"_35":36,"_175":40,"_176":24,"_37":228,"_39":26,"_70":71,"_178":186,"_72":30,"_179":-5,"_218":229,"_17":230},{"_33":221,"_13":222,"_67":223,"_43":-5,"_35":36,"_175":40,"_176":24,"_37":224,"_39":26,"_70":21,"_178":225,"_72":30,"_179":-5,"_218":226,"_17":227},{"_33":213,"_13":214,"_67":215,"_43":-5,"_35":36,"_175":123,"_176":24,"_37":216,"_39":26,"_70":71,"_178":217,"_72":30,"_179":-5,"_218":219,"_17":220},"e75dfb58-7608-11f0-8d59-0224a6c84d84","new-file-7775.tsx","e75dfc2a-7608-11f0-8d59-0224a6c84d84",["D",1754844106191],"","children",[],[214],"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",[],[222],["D",1754844097514],[],[18,69],["D",1754844097514],[],[18,80],"e24201b4-7608-11f0-a77a-0224a6c84d84","App.tsx","019894db-ec4f-76e8-976e-ea3baba9c5b3",["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;",[],[18,85,235],["D",1754844097514],[208],[18,85],["D",1754844097514],[207,209,210],[18],"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;",[],[255,248],"backend","e241ff84-7608-11f0-a77a-0224a6c84d84",["D",1754844097514],[205],[255],["D",1754844097514],{"_11":12,"_140":75},{"_11":12,"_136":-5,"_74":75,"_31":73,"_137":138,"_139":30},{"_39":123,"_13":16,"_33":36,"_124":89,"_125":126,"_127":128,"_129":94,"_130":131,"_132":133,"_134":14,"_135":12},"ctx",{"_51":-5,"_161":297,"_298":299,"_300":301,"_302":30,"_303":30,"_304":30,"_305":24,"_306":-5,"_307":-7,"_308":-7,"_309":26,"_310":30,"_311":30,"_312":-5,"_313":30,"_314":30,"_315":30,"_316":-5},"ENV",{"_268":269,"_270":271,"_272":16,"_273":274,"_275":276,"_277":278,"_279":280,"_281":282,"_283":284,"_285":286,"_287":288,"_289":290,"_291":292,"_293":294,"_295":296},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5a709144666c9e69e88140f015c586412f0fd8d3","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