🍴 Forky

A simple web application that allows you to fork Val Town projects with a clean user interface.

Forky 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.

• Fork any public Val Town project with a single click
• Preserves the entire project structure, including all files and directories
• Maintains project metadata (descriptions, images, etc.)
• Clean, responsive UI built with React and TailwindCSS

• A Val Town account
• A Val Town API token with project read and write permissions

1. Enter the URL of the Val Town project you want to fork (format: https://www.val.town/x/username/projectname)
2. Enter your Val Town API token with the proper project:write permissions
3. Click "Fork" and wait for the process to complete
4. Once successful, you'll have a new copy of the project in your Val Town account under a new generated name

├── backend
│   └── index.ts           # Backend server and API endpoints
├── frontend
│   ├── components
│   │   └── App.tsx        # Main React component
│   ├── index.html         # HTML entry point
│   └── index.tsx          # Frontend JavaScript entry point
└── README.md              # This file

Forky uses the Val Town SDK to:

1. Retrieve information about the source project
2. Create a new project in your account
3. Copy all files from the source project to your new project
4. Preserve the project structure and metadata

The application exposes the following API endpoint:

• POST /fork?url={encoded-url} - Forks the specified project
  • Requires an Authorization header with a Bearer token
  • Returns a JSON response with success or error information