Readme file updated.

Author: kodzamani

.DS_Store

@@ -2,13 +2,15 @@
 
 <div align="center">
 
+![DevAtlas Logo](./DevAtlasMac/Assets.xcassets/Icons/logo_brand.imageset/logo_brand-2.png)
+
 ![Platform](https://img.shields.io/badge/platform-macOS%2014%2B-blue?logo=apple)
 ![Swift](https://img.shields.io/badge/Swift-5.9-orange?logo=swift)
 ![SwiftUI](https://img.shields.io/badge/SwiftUI-5-green)
 ![License](https://img.shields.io/badge/license-MIT-lightgrey)
 
-**The all-in-one developer workspace manager for macOS.**  
-Scan, analyze, and navigate all your coding projects — without ever leaving your screen.
+**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.
 
 [Features](#-features) • [Getting Started](#-getting-started) • [Tech Stack](#-tech-stack) • [Contributing](#-contributing)
 
@@ -18,16 +20,35 @@ Scan, analyze, and navigate all your coding projects — without ever leaving yo
 
 ## What is DevAtlas?
 
-DevAtlas is a native macOS app built with SwiftUI that acts as a **mission control for developers**. It automatically discovers every project on your machine, detects the language and framework, checks your dependencies for updates, analyzes unused code, visualizes Git activity, and lets you jump into any editor with a single click — all from one beautiful, fast interface.
+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.
+
+## Why It Stands Out
+
+- **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
+- **Zero third-party runtime dependencies**: built entirely on Apple's native frameworks
+
+## Screenshots
 
-> Supports **20+ languages and frameworks** out of the box: Swift, Node.js, React, Next.js, Vue, Angular, Flutter, Go, Rust, Python, Java, PHP, Ruby, .NET, Docker, and more.
+| Screen | Description | Screenshot |
+|---|---|---|
+| Atlas | Main workspace view for discovering, filtering, and opening local projects. | <img src="./docs/app.png" alt="Atlas" width="500" /> |
+| Stats | Portfolio-level dashboard for code volume, project mix, and Git activity. | <img src="./docs/stats.png" alt="Stats" width="500" /> |
+| Notebook | Project-linked notes and todos with Markdown editing and organization tools. | <img src="./docs/notebook.png" alt="Notebook" width="500" /> |
+| AI Prompts | Curated engineering prompts for audits, refactoring, testing, and documentation workflows. | <img src="./docs/ai_prompts.png" alt="AI Prompts" width="500" /> |
+| Settings | App preferences for theme, language, scanning behavior, and personalization. | <img src="./docs/settings.png" alt="Settings" width="500" /> |
 
 ---
 
 ## ✨ Features
 
 ### 🔍 Intelligent Project Discovery
-DevAtlas scans all mounted disks on your Mac and automatically maps every coding project it finds. Projects are auto-categorized into **Web**, **Mobile**, **Desktop**, and **Cloud** — and refreshed in the background as you work.
+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`, ...)
@@ -38,7 +59,7 @@ DevAtlas scans all mounted disks on your Mac and automatically maps every coding
 ---
 
 ### 🤖 AI-Powered Code Analysis
-DevAtlas integrates **40+ AI-powered prompts** across 14 categories to help you improve your codebase. These prompts are designed to work with Claude, ChatGPT, or any LLM of your choice.
+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.
 
 #### 📊 Code Quality
 | Prompt | Description |
@@ -51,8 +72,8 @@ DevAtlas integrates **40+ AI-powered prompts** across 14 categories to help you
 
 #### ⚡ Performance
 | Prompt | Description |
-|-------- Bottleneck Analysis|-------------|
-| | Holistic performance audit with profiling suggestions |
+|--------|-------------|
+| Bottleneck Analysis | Holistic performance audit with profiling suggestions |
 | SwiftUI Render Optimization | View rendering efficiency improvements |
 | App Launch Optimization | Minimize time-to-interactive |
 
@@ -65,8 +86,8 @@ DevAtlas integrates **40+ AI-powered prompts** across 14 categories to help you
 
 #### 🧪 Testing
 | Prompt | Description |
-| Test Coverage Analysis | Identify|--------|-------------|
- untested code paths |
+|--------|-------------|
+| Test Coverage Analysis | Identify untested code paths |
 | Unit Test Audit | Test quality and reliability review |
 | Test Generator | Generate production-quality unit tests |
 
@@ -89,7 +110,7 @@ DevAtlas integrates **40+ AI-powered prompts** across 14 categories to help you
 ---
 
 ### 📦 Dependency Management & Version Checker
-See all your project's dependencies at a glance — and know instantly which ones are outdated.
+Dependency insight is built into the project detail flow. DevAtlas parses manifests directly from each repository and aggregates regular, development, and grouped project dependencies where applicable.
 
 | Ecosystem | Manifest File |
 |---|---|
@@ -101,12 +122,8 @@ See all your project's dependencies at a glance — and know instantly which one
 | Swift (CocoaPods) | `Podfile` |
 | Swift (Carthage) | `Cartfile` |
 | .NET / C# | `.csproj`, `.sln` |
-| Java | `pom.xml`, `build.gradle` |
-| Python | `requirements.txt`, `pyproject.toml` |
-| PHP | `composer.json` |
-| Ruby | `Gemfile` |
 
-DevAtlas fetches the **latest available version** of each package directly from the relevant registry (npm, pub.dev, crates.io, pkg.go.dev, etc.) using concurrent async requests — so you always know what needs updating.
+DevAtlas also checks package versions against upstream registries so outdated dependencies are visible without manually opening each manifest.
 
 ---
 
@@ -123,7 +140,7 @@ Dead code is technical debt. DevAtlas scans your source files and highlights sym
 ---
 
 ### 📊 Project Statistics & Git Insights
-A full picture of your codebase health — across every project, at once.
+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
@@ -134,7 +151,7 @@ A full picture of your codebase health — across every project, at once.
 ---
 
 ### 📝 Notebook
-A lightweight, project-linked note-taking system built right in.
+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**
@@ -145,12 +162,12 @@ A lightweight, project-linked note-taking system built right in.
 ---
 
 ### ⚡ Quick Actions
-Stop hunting through Finder. Open any project directly in your preferred editor:
+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**, **Zed**, and more
+- **VS Code**, **Xcode**, **Cursor**, **Windsurf**, **Antigravity**
 - Open in **Terminal** or **Finder** with one click
 - `⌘P` keyboard shortcut for instant project search
-- Run project scripts directly from the app
+- Run detected Node-based project scripts directly from the app
 
 ---
 
@@ -162,10 +179,10 @@ Stop hunting through Finder. Open any project directly in your preferred editor:
 
 ---
 
-### 🌍 Localization & Accessibility
-- 10+ languages: English, Turkish, German, French, Italian, Japanese, Korean, Simplified Chinese, and more
-- Full **Dark Mode** support
-- Native macOS look and feel with smooth animations
+### 🌍 Localization
+- 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
 
 ---
 
@@ -187,7 +204,7 @@ Zero third-party dependencies — built entirely on top of Apple's native framew
 ## 🚀 Getting Started
 
 ```bash
-git clone https://github.com/aygundev/DevAtlasMac.git
+git clone https://github.com/kodzamani/DevAtlasMac.git
 cd DevAtlasMac
 open DevAtlasMac.xcodeproj
 ```
@@ -222,7 +239,7 @@ DevAtlasMac/
 ├── Models/                       # Data models
 ├── Components/                   # Reusable SwiftUI components
 ├── Extensions/                   # Swift extensions & helpers
-└── *.lproj/                      # Localization strings (10+ languages)
+└── *.lproj/                      # Localization strings
 ```
 
 ---