Reverse Engineering

Project Name Field

Enter the name of the project to be created.

Example

Midlands Clinic Appointment System

Description Field

Provides an optional summary or overview of the project.

Example

Clinic appointment and patient scheduling platform.

Cancel Button

Closes the dialog without creating a project.

Create Project Button

Creates the new project and proceeds to the next setup step.

Supported Sources

• Version control repositories
• Public GitHub repositories
• ZIP archive files

Recommended For

• Existing applications
• Legacy systems
• Ongoing development projects 
• Previously developed source code

Action

Click Choose Source to continue to the import options screen.

Customer can import projects from 3 options:

• Public GitHub URL
• ZIP File
• Git Provider (advanced)

This page is typically accessed when creating a new project or adding source code to an existing workspace.

These options allow customers to:

• Integrate existing applications into the platform
• Continue development from external repositories
• Upload archived project files
• Synchronize source code with version control systems

Importing Source Code via Public GitHub URL

When you choose to seed an empty workspace using an existing project repository, the platform provides a dedicated wizard to pull code seamlessly from open-source version control.

This option imports source code from a publicly accessible GitHub repository.

Functions

• Download project snapshots
• Clone public repositories
• Import application source files into the workspace

User Requirement

The user must provide a valid public GitHub repository URL.

Parameter Configurations & Rules

• Repository URL: Paste the complete, publicly accessible HTTP link to your target repository (e.g., https://github.com/expressjs/express). Private repositories requiring SSH key encryption or explicit developer tokens are not supported by this basic link wizard.
• Branch Specification: Define the explicit branch string you want to target (e.g., main or development). If you leave this field empty, or if the specified branch cannot be found in the repository index, the system automatically falls back to pulling from the default master branch.

Executing the Repository Sync

1. Enter your specific repository location and target branch into the modal text blocks.
2. Click the white ← Back button to return to the source selection menu if you need to choose an alternative upload path (like a local ZIP archive).
3. Click the solid purple 📥 Import repository action button to start the automated transfer.
4. The platform will automatically connect to GitHub, download a snapshot of the codebase, extract the file structure, and initialize the project components directly within your working developer canvas.

Importing Source Code via ZIP Archive

When setting up a project workspace from an existing codebase, the platform provides a local file upload wizard as an alternative to external version control tracking.

This option allows you to upload a compressed archive directly from your local computer. The system will automatically unpack and map the contained directories into your designated project folder.

Features:

• Upload local project archives
• Extract application files automatically
• Import existing codebases into the workspace

Supported Content

ZIP files containing:

• Source code
• Assets
• Configuration files
• Project folders

Core Functions

• Upload Local Project Archives: Browse your local directories to select and transmit bundled application code structures.
• Extract Application Files Automatically: The backend system instantly runs an unzipping routine upon completing the upload, parsing your file trees without requiring manual terminal extraction commands.
• Import Existing Codebases into the Workspace: Populates your empty developer environment with your historical logic blocks, configuration settings, and static assets in one step.

Step-by-Step Upload Procedure

1. Click the Choose File target button within the configuration modal to trigger your operating system's native file explorer.
2. Locate and select the targeted .zip archive containing your application files.
3. Verify that the correct archive filename appears next to the selection button.
4. If you need to switch to an alternative seed method (such as pulling from a public GitHub URL), click the white ← Back button.
5. Click the solid purple 📤 Upload & Extract action button to initiate the transfer process.
6. Keep your browser window open while the file is processed; once complete, your unpacked folder architecture will populate directly into the left side of your developer canvas.

What is a VCS?

VCS stands for Version Control System.

A Version Control System is a tool used to:

• Store and manage source code
• Track file and code changes over time
• Support collaboration between multiple developers
• Maintain version history and backups
• Restore previous versions when needed

Common VCS platforms include:

• GitHub
• GitLab
• Bitbucket

How to Connect Project using VCS:

• Select Connect my version control.
• Authenticate with the repository provider.
• Select the repository to import.
• Confirm synchronization settings by clicking on Save Integrations.

Project Folder

Displays the target project workspace where the repository will be connected.

Purpose

Determines which local project folder will synchronize with the Git repository.

Example

midlands_clinic_appointment_system

Purpose

Defines the repository protocol and integration type.

Integration Name

Allows users to assign a custom name for the repository connection.

Example

Main Repository

Purpose

Helps identify repository integrations within the platform.

Default Branch

Specifies the primary branch that the workspace will synchronize with.

Example

Smain

Repository URL

Field used to enter the Git repository address.

Example

https://github.com/username/repo.git

Purpose

Identifies the remote repository to connect and synchronize with.

Authentication Method

Specifies how the system authenticates with the repository provider.

Example

Access token

Supported Authentication Types

May include:

• Access Token
• SSH Key
• Username and Password
• OAuth Authentication

Personal Access Token

Secure field used to enter the repository access token.

Purpose

Provides secure authentication for:

• Pull operations
• Push operations
• Repository synchronization

Access tokens should be kept confidential and securely managed.

Enable Auto-Sync

Checkbox option that automatically synchronizes repository updates.

Functions

• Automatically pull repository changes
• Keep workspace updated
• Simplify collaboration workflows

Back Button

Returns the user to the previous setup screen without saving changes.

Save Integration Button

Saves the repository configuration and establishes the connection.

Notes and Recommendations

Saves the repository configuration and establishes the connection.

• Ensure the repository URL is valid and accessible.
• Verify that the access token has sufficient permissions.
• Use auto-sync for active collaborative development projects.
• Protect access tokens and avoid sharing credentials publicly.
• Confirm the correct default branch before saving the integration.