A native macOS command center for your entire local codebase.
Discover projects, inspect dependencies, analyze code health, track Git activity, keep project notes, and jump into work instantly.

Screenshots • Features • Getting Started • Tech Stack • Contributing

DevAtlas is a native macOS app built with SwiftUI for developers who manage many local repositories at once. It scans your disks, identifies real projects from ecosystem-specific marker files, groups them by category and recency, surfaces dependency and code-health signals, and gives you one place to open, inspect, and continue work.

Instead of acting like another launcher, DevAtlas combines workspace discovery, codebase intelligence, Git analytics, project notes, and quick actions in a single desktop app.

• Whole-machine project discovery: scans your home folder and mounted volumes, with smart exclusions and custom ignore paths
• Polyglot project understanding: recognizes Swift, Node.js, Flutter, Go, Rust, .NET, Python, Java, Docker, and more from real project markers
• Built-in dependency visibility: parses manifests across multiple ecosystems and shows what each project depends on
• Actionable code insights: includes unused code analysis, AI prompt workflows, line/file metrics, and Git activity trends
• Native developer workflow: open projects in installed editors, Terminal, Finder, or Xcode without leaving the app
• Finder-style workspace: browse projects as icons, a sortable list, or columns, with category and tag filters, navigation history, and a preview pane
• Native rendering: built with SwiftUI, Swift Charts, and Metal effects, with MarkdownUI for rich Markdown content

Explore the app through the screenshots below. Click any image to view it at full size.

Browse color-coded project folders grouped by recency. The sidebar filters projects by category or tag; the preview pane shows the selected project's metadata and quick actions.

A compact, sortable table shows project names, modification dates, types, Git branches, and tags alongside the project preview.

Navigate from project type to repository to preview in a three-column browser, with a path bar and workspace totals below.

Open a project to read its README, inspect Git status and the latest commit, review its language distribution and dependencies, and launch an editor or terminal.

Inspect file and line totals, average file size, the largest source files, and language distribution, with access to unused code analysis.

Portfolio metrics, Git additions and deletions, activity charts, a contribution heatmap, and project distribution charts share one dashboard. Date filters and CSV export live in the toolbar.

A multi-pane notebook keeps note collections, project-linked notes, the Markdown editor, and todo lists together.

Browse 29 engineering prompts across 12 categories, preview their contents, and copy them into your preferred AI assistant.

DevAtlas's core strength is automatic project indexing across your machine. It scans mounted volumes and your home directory, resolves symlinks, removes duplicates, skips noisy folders, and turns raw directories into a structured project atlas.

• Full-disk recursive scan with smart exclusions (node_modules, .git, build, dist, etc.)
• Auto-detects project type from marker files (package.json, go.mod, pubspec.yaml, Dockerfile, ...)
• Timeline grouping: Today, This Week, This Month, Older
• Icon, list, and column views with a shared category and tag sidebar
• Project preview pane with metadata, editor shortcuts, and a clickable path bar
• Back/forward navigation with ⌘[ / ⌘]
• Live project search with ⌘P or ⌘F; toggle the preview pane with ⇧⌘P
• Custom exclusion paths for personalized scanning

DevAtlas ships with a dedicated prompt workspace for reviewing, refactoring, documenting, and stress-testing your code with external LLMs. The prompts are organized by engineering intent, so the app becomes a practical launchpad for deeper audits instead of a generic prompt list.

• Debugging: Crash analysis, Xcode Instruments guide
• Networking: API audit, mocking setup
• Accessibility: WCAG 2.1 AA and Apple HIG compliance
• Localization: i18n/l10n audit
• CI/CD: Git workflow, pipeline design
• Dependencies: Third-party dependency audit
• Code Generation: CRUD generator, boilerplate generator

Dependency insight is built into the project overview alongside a README preview, Git status, the latest commit, and a language breakdown. DevAtlas parses manifests directly from each repository and aggregates regular, development, and grouped project dependencies where applicable.

DevAtlas also checks package versions against upstream registries so outdated dependencies are visible without manually opening each manifest.

Dead code is technical debt. DevAtlas scans your source files and highlights symbols that are defined but never used:

• Swift — functions, classes, structs, enums, variables
• C# — unused classes and methods
• JavaScript / TypeScript — unreferenced exports and declarations
• Dart — unused declarations

💡 Smart Detection: The unused code analysis button only appears when your project uses a supported language (Swift, C#, JavaScript, or Dart).

The stats dashboard turns your local repos into a portfolio-level view. It combines code volume, project mix, and Git contribution history into one interface built with Swift Charts.

• Total file count and lines of code per project
• Git commit history: commit count, activity graph, lines added/deleted
• Date-range filtering for Git stats
• Export statistics as CSV from the toolbar
• Interactive Charts for visualizing data

DevAtlas includes a local notebook layer so project context stays attached to the codebase instead of being scattered across separate apps.

• Notes and tasks tied to specific projects
• Full Markdown rendering
• Tag and category system for quick filtering
• Cross-project search by content, project, or tag
• Todo items with priority levels and status tracking

Once a project is indexed, DevAtlas is also the fastest way back into it. Quick actions are designed for immediate context switching between discovery and execution.

• VS Code, Xcode, Cursor, Windsurf, Antigravity
• Open in Terminal or Finder with one click
• ⌘P / ⌘F keyboard shortcuts for instant project search
• Run detected Node-based project scripts directly from the app

• Finder-style sidebar with project counts, category filters, and colored tags
• Unified toolbar with contextual controls, search, and navigation history
• Icon, list, and column layouts, an optional preview pane, and a bottom path/status bar
• Metal-rendered folder icons and a subtle animated accent background
• Light, Dark, and System appearance with custom accent colors
• Multi-pane notebook and card-based project, statistics, and prompt screens

• Localized UI for English, Turkish, German, French, Italian, Japanese, Korean, and Simplified Chinese
• Language switching built into settings
• Native SwiftUI interface with macOS-first interaction patterns

Apple's native frameworks power the interface, charts, and shader effects. MarkdownUI provides rich Markdown rendering and is resolved through Swift Package Manager.

git clone https://github.com/kodzamani/DevAtlasMac.git
cd DevAtlasMac
open DevAtlasMac.xcodeproj

Let Xcode resolve the Swift package dependencies, then press ⌘R to build and run.

Requirements: macOS 14.0 or later · Xcode 15.0 or later

DevAtlasMac/
├── DevAtlasMacApp.swift          # App entry point
├── ContentView.swift             # NavigationSplitView shell & workspace routing
├── Views/
│   ├── Shell/                    # Sidebar & contextual window toolbar
│   ├── Atlas/                    # Icon, list, column, preview & detail views
│   ├── Stats/                    # Statistics dashboard
│   ├── Notebook/                 # Note-taking
│   ├── Settings/                 # App preferences
│   ├── Onboarding/               # First-launch walkthrough
│   └── AIPrompts/                # Curated AI prompt library
├── ViewModels/                   # Business logic & state
├── Services/
│   ├── ProjectScanner.swift      # Disk-scanning engine
│   ├── DependenciesService.swift
│   ├── VersionCheckerService.swift
│   ├── GitStatsService.swift
│   ├── Dependencies/             # Per-ecosystem manifest parsers
│   └── UnusedCodeAnalyzer/       # Static analysis engine
├── Models/                       # Data models
├── Components/                   # Reusable SwiftUI components
│   └── Shaders/                  # Folder icons & animated surfaces
├── Shaders/                      # Metal shader functions
├── Extensions/                   # Swift extensions & helpers
└── *.lproj/                      # Localization strings

Contributions are welcome!

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your changes: git commit -m 'Add your feature'
4. Push: git push origin feature/your-feature
5. Open a Pull Request

Please open an issue first for significant changes.

This project is licensed under the MIT License.