Skip to main content

Uploading Source Code

The source code step at /repositories/:repositoryId/source is where you provide the material that Smart Engineering will analyze. The supported input method is a .zip upload.

When to use​

  • Use this step after creating a repository.
  • Use it to upload the source code that will be processed.
  • Use it to review upload history or continue when source code already exists.

Before you start​

  • Confirm the correct repository.
  • Compress the source code into a single .zip file.
  • Remove unnecessary files when they do not help the analysis.

Validation rules​

  • The file must use the .zip extension.
  • A repository is required.
  • A file is required when the repository does not already have source code.

Source methods​

  • Upload .zip: currently available and selected by default.

Step by step​

The user-facing flow is:

  1. Select or drag the .zip file.
  2. Request an upload URL.
  3. Upload the file to storage.
  4. Confirm the upload with the API.
  5. Process the code.
  6. Run or review the pre-analysis result when it becomes available.

You can remove the selected file before submitting, check the upload history, continue without a new file when the repository already has source code, or return to the repository overview.

Pre-analysis​

After processing, the pre-analysis summarizes what was found in the repository. Depending on the API response, it can include:

  • Number of files.
  • Total lines.
  • Lines of code.
  • Detected languages or stacks.
  • Code density.
  • LLM cost estimates.
  • Model context windows.
  • Model recommendations.

This step prepares the repository for task creation. If pre-analysis is not ready, the tasks tab can remain locked in the repository workspace.

Expected result​

The repository should move into processing, show the pre-analysis, and become ready for task creation.

See also​