feat: initial project setup with Electron, React, Vite, and CI/CD

Author: BeardedTech0o

.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Build & Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Build Electron
+        run: npm run dist
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            dist/DiskOH-Setup.exe
+            dist/DiskOH-*.exe
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,40 @@
+name: Test & Build
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: windows-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Run smoke tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Test Electron build
+        run: npm run electron-build
+        continue-on-error: true

.gitignore

@@ -0,0 +1,43 @@
+# Archives
+*.zip
+*.tar.gz
+*.rar
+*.7z
+
+# Dependencies
+node_modules/
+.pnp/
+.pnp.js
+
+# Environment & secrets
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+build/
+out/
+.next/
+
+# OS files
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Editor
+.vscode/
+.idea/
+*.suo
+*.user
+
+# Logs
+*.log
+npm-debug.log*
+
+# Misc
+.cache/
+*.tmp
+
+# Electron
+**/node_modules

README.md

@@ -0,0 +1,89 @@
+# DiskOH - Modern Disk Space Analyzer
+
+[![Build Status](https://github.com/BeardedTech0o/DISK-OH/actions/workflows/test.yml/badge.svg)](https://github.com/BeardedTech0o/DISK-OH/actions)
+
+A modern, beautiful disk space analyzer for Windows built with Electron, React, and TypeScript.
+
+## Features
+
+- **Interactive Treemap Visualization** - See your disk usage at a glance with drill-down exploration
+- **Dark Mode Support** - System theme detection and manual toggle
+- **Multi-Drive Analysis** - Compare usage across multiple drives
+- **File Deletion** - Safely delete folders with confirmation dialogs
+- **Auto-Updates** - Automatic dependency and app updates with safety checks
+- **Windows Native** - NSIS installer, UAC elevation, full drive access
+
+## Installation
+
+Download the latest `DiskOH-Setup.exe` from [Releases](https://github.com/BeardedTech0o/DISK-OH/releases) and run it.
+
+## Development
+
+### Prerequisites
+- Node.js 18+
+- npm or yarn
+
+### Setup
+```bash
+npm install
+```
+
+### Commands
+```bash
+# Start development server with hot reload
+npm run dev
+
+# Build React bundle
+npm run build
+
+# Run Electron app with built bundle
+npm run electron-dev
+
+# Run smoke tests
+npm test
+
+# Build Windows installer (.exe)
+npm run dist
+```
+
+## Architecture
+
+- **Main Process** (Node.js) - Handles file system access, disk scanning, updates
+- **Renderer Process** (React) - UI with treemap visualization and settings
+- **IPC Communication** - Safe bridge between main and renderer processes
+
+## Project Structure
+
+```
+src/
+├── main/              # Electron main process
+│   ├── main.ts       # App entry point
+│   ├── preload.ts    # IPC bridge
+│   ├── scanner.ts    # Disk scanning logic
+│   ├── drive-utils.ts # Windows drive enumeration
+│   ├── file-ops.ts   # File deletion
+│   ├── updater.ts    # Auto-updates
+│   └── smoke-tests.ts # Post-update validation
+├── renderer/          # React UI
+│   ├── App.tsx
+│   ├── components/    # UI components
+│   └── main.tsx      # React entry
+└── shared/            # Shared types & constants
+```
+
+## Update Strategy
+
+**npm Dependencies**: Uses caret ranges (^) allowing minor/patch updates only. Major versions are pinned and require manual updates.
+
+**App Updates**: electron-updater checks GitHub releases on startup. Updates are silent and installed on next launch.
+
+**Safety**: Smoke tests run after updates validate core functionality.
+
+## CI/CD
+
+- **test.yml** - Runs on every push: type checking, tests, build
+- **release.yml** - Runs on version tags: builds installer and creates GitHub release
+
+## License
+
+MIT

index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>DiskOH - Disk Space Analyzer</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/renderer/main.tsx"></script>
+  </body>
+</html>

package.json

@@ -0,0 +1,64 @@
+{
+  "name": "disk-oh",
+  "version": "0.1.0",
+  "description": "Modern disk space analyzer for Windows",
+  "main": "dist/main/main.js",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "test": "node --test src/main/smoke-tests.ts",
+    "preview": "vite preview",
+    "electron-dev": "electron .",
+    "electron-build": "vite build && electron .",
+    "dist": "electron-builder",
+    "dist:win": "electron-builder --win"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "recharts": "^2.10.0",
+    "tailwindcss": "^3.4.0",
+    "electron-updater": "^6.1.0",
+    "lucide-react": "^0.263.1"
+  },
+  "devDependencies": {
+    "@tauri-apps/cli": "^2.2.0",
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.43",
+    "@types/react-dom": "^18.2.17",
+    "@vitejs/plugin-react": "^4.2.1",
+    "autoprefixer": "^10.4.16",
+    "electron": "^30.0.0",
+    "electron-builder": "^24.9.0",
+    "postcss": "^8.4.31",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.7"
+  },
+  "build": {
+    "appId": "com.beardedtech.diskoh",
+    "productName": "DiskOH",
+    "directories": {
+      "buildResources": "public"
+    },
+    "files": [
+      "dist/**/*"
+    ],
+    "win": {
+      "target": [
+        {
+          "target": "nsis",
+          "arch": [
+            "x64"
+          ]
+        }
+      ]
+    },
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "createStartMenuShortcut": true
+    }
+  }
+}

postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

src/main/drive-utils.ts

@@ -0,0 +1,40 @@
+import { execSync } from 'child_process'
+import { DriveInfo } from '../shared/types.js'
+
+export function getDrives(): DriveInfo[] {
+  const drives: DriveInfo[] = []
+
+  try {
+    // Windows: use wmic to get drive info
+    const output = execSync(
+      'wmic logicaldisk get name,size,freespace /csv',
+      { encoding: 'utf-8' }
+    )
+
+    const lines = output.trim().split('\n')
+    // Skip header
+    for (let i = 1; i < lines.length; i++) {
+      const parts = lines[i].split(',')
+      if (parts.length >= 3) {
+        const letter = parts[0].trim()
+        const total = parseInt(parts[1].trim()) || 0
+        const free = parseInt(parts[2].trim()) || 0
+        const used = total - free
+
+        if (letter && total > 0) {
+          drives.push({
+            letter: letter.replace(':', ''),
+            name: letter,
+            total,
+            used,
+            free,
+          })
+        }
+      }
+    }
+  } catch (err) {
+    console.error('Failed to get drives:', err)
+  }
+
+  return drives
+}

src/main/file-ops.ts

@@ -0,0 +1,38 @@
+import fs from 'fs/promises'
+import path from 'path'
+
+export async function deleteFile(filePath: string): Promise<void> {
+  try {
+    const stat = await fs.stat(filePath)
+
+    if (stat.isDirectory()) {
+      // Recursively delete directory
+      await deleteDirectory(filePath)
+    } else {
+      // Delete file
+      await fs.unlink(filePath)
+    }
+  } catch (err) {
+    throw new Error(`Failed to delete ${filePath}: ${err}`)
+  }
+}
+
+async function deleteDirectory(dirPath: string): Promise<void> {
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true })
+
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name)
+
+      if (entry.isDirectory()) {
+        await deleteDirectory(fullPath)
+      } else {
+        await fs.unlink(fullPath)
+      }
+    }
+
+    await fs.rmdir(dirPath)
+  } catch (err) {
+    throw new Error(`Failed to delete directory ${dirPath}: ${err}`)
+  }
+}