AI VIBE CODING RECOVERY TOOL DOCUMENTATION
By: Clinton Gallagher (clintongallagher.com)
      414-243-8211 CST

If you provide this tool with a zip archive of a project that was Saved Early and Saved Often you will have all of the folders and file assets to recover from a –whatever– like a fatal error. 

The tool will get the source code from every file and wrap it in structured comments the vibe coding apps need to rebuild. The tool provides you with the choice to retrieve the entire project or any individual file you want to reuse for whatever reason you may have in mind.

RECOMMENDATION: Save the collection to disk with a date stamp and a name such as 2025-OCT-20-MasterRecoveryFile.txt and submit the text file with a prompt to the vibe coding app of your choice. For example…

“The uploaded file contains all of the source code required to generate an app. Please parse it and do so.”

NOTE: this tool was developed as a ReactJS app that generally requires being run on a server. You have been provided with the source files that enable you to do so. The source code can also be loaded in Visual Studio Code for example using NodeJS with the package manager of your choice to build and run it. Finally the following instructions make it possible to understand how to put the source code on your file system and run index.html in a browser locally.

RUN LOCAL OPTION 1:
NodeJS is required to be installed on your machine that you likely also use with Visual Studio Code for one reason or another.

Unzip the archive anywhere you want on the file system. Open its folder in Visual Studio Code. Then open a Context Menu on the folder when it is in the VSCode editor and open a terminal.

Terminal: npm install
(installs node into the project)

Terminal: npm run build
(runs vite and builds the app)

Terminal: npm run preview
o + enter 
('o'pens the tool in the default browser)

ANYBODY CAN RUN LOCAL OPTION 2:
Unzip the archive anywhere you want on your file system. Inside the folder you will have a dist directory (folder) that contains the index.html file.

Clicking the index.html can launch the tool in a browser using the HTTP file: schema however there are often other apps and services on our computers that may have click event priority. Clicking might load Visual Studio Code for example which is fine when you want to use it to build and deploy the source code to run on or with a server; that is an annoyance if you just want to click and run the index.html file in a browser and get to work.

If nothing captures the click event the default browser will load and you can get to work restoring your code to any vibe coding app you want. Unless you changed your preferences Edge will be  the default browser on Windows 10 and Windows 11 computers. On Mac it will likely be Safari. On Linux distros likely Firefox.

Option A: right mouse click on the index.html file in the dist folder and open a Context Menu. From the Context Menu Select ‘Open with’ and choose the browser you want to use.