> ## Documentation Index
> Fetch the complete documentation index at: https://docs.traceback.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# traceback sourcemaps

> Upload and validate JavaScript source maps and native debug symbols.

## Usage

```bash theme={null}
traceback sourcemaps upload [options] <path_to_directory>
```

## Description

Scans the specified directory for `.map` files, bundles them into an encrypted archive, and uploads them to Traceback associated with a release tag.

## Examples

```bash theme={null}
# Upload build directory for release 2.1.0
traceback sourcemaps upload --release="v2.1.0" ./dist

# Upload and remove source maps from local disk afterwards
traceback sourcemaps upload --release="v2.1.0" --clean ./build
```

## Options

| Option                  | Required | Description                                    |
| :---------------------- | :------- | :--------------------------------------------- |
| `--release <version>`   | Yes      | The release version string (or git commit SHA) |
| `--project <name>`      | No       | Project slug (if not inferred from config)     |
| `--url-prefix <prefix>` | No       | URL prefix for source files (e.g. `~/assets/`) |
| `--clean`               | No       | Delete `.map` files after successful upload    |