Configuration File Guide
Configure RepoAtlas project defaults using repo-atlas.config.json or .repo-atlasrc.
2 min read•Updated July 22, 2026
RepoAtlas automatically resolves configuration options from your project root. CLI arguments always override configuration file values.
Supported Config Files
| File | Format |
|---|---|
repo-atlas.config.json | JSON |
repo-atlas.config.yaml | YAML |
repo-atlas.config.ts | TypeScript |
repo-atlas.config.js | JavaScript |
.repo-atlasrc | JSON |
Configuration Options
| Option | Type | Default | Description |
|---|---|---|---|
theme | string | "unicode" | Default rendering theme |
iconPack | string | "emoji" | Default icon pack |
maxDepth | number | 10 | Maximum recursion depth |
sort | string | "name" | Sort strategy |
only | string | "all" | Filter nodes |
respectGitIgnore | boolean | true | Honor .gitignore rules |
ignorePatterns | string[] | [] | Additional glob patterns to ignore |
outputFile | string | undefined | Default output file path |
Example: repo-atlas.config.json
json
1{
2 "theme": "vscode",
3 "iconPack": "emoji",
4 "maxDepth": 4,
5 "sort": "name",
6 "only": "all",
7 "respectGitIgnore": true,
8 "ignorePatterns": [
9 "*.log",
10 "dist/",
11 "coverage/"
12 ],
13 "outputFile": "PROJECT_STRUCTURE.md"
14}Example: repo-atlas.config.ts
typescript
1import { defineConfig } from '@repoatlasdev/config';
2
3export default defineConfig({
4 theme: 'material',
5 iconPack: 'vscode',
6 maxDepth: 6,
7 respectGitIgnore: true,
8 ignorePatterns: ['*.log', 'coverage/', '.cache/'],
9});