Workstation Setup 🚀

Deine komplette Dev-Umgebung in der richtigen Reihenfolge installiert.

📑 Inhaltsverzeichnis

• Grundlagen
  • Chocolatey Package Manager
  • Git
  • WSL (Windows Subsystem for Linux)
• Development Tools
  • VS Code
  • Node.js & npm
  • Flutter
  • Docker Desktop & Docker Compose
• Datenbank & Browser
  • Azure Data Studio
  • Brave Browser
• Git Tools
  • GitHub Desktop
• AI Tools
  • Claude Code
• PowerShell Setup
  • Dev-Ordner als Standard setzen
  • Git-Branches anzeigen
• Weitere nützliche Tools
• Wartung

---

Grundlagen 🔧

1. Chocolatey Package Manager

Chocolatey ist dein Paketmanager für Windows - damit installierst du alles Weitere. Das muss als Erstes installiert werden!

Set-ExecutionPolicy Bypass -Scope Process -Force; `
[System.Net.ServicePointManager]::SecurityProtocol = `
[System.Net.ServicePointManager]::SecurityProtocol -bor 3072; `
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

choco --version

2. Git

Git brauchen wir früh, da viele Tools darauf aufbauen.

choco install git -y

git --version

3. WSL (Windows Subsystem for Linux)

WSL installieren und konfigurieren, bevor Docker kommt (Docker braucht WSL als Backend).

wsl --install
wsl --status
wsl --install -d Debian

Hinweis: Nach der WSL-Installation ist ein Neustart erforderlich!

---

Development Tools 💻

4. VS Code

Dein Code-Editor - installieren wir früh, damit du schon damit arbeiten kannst.

choco install vscode -y

5. Node.js & npm

Node und npm für JavaScript/TypeScript Entwicklung.

choco install nodejs-lts -y

node -v
npm -v

6. Flutter

Flutter für Cross-Platform App-Entwicklung.

choco install flutter -y

flutter --version
flutter doctor

7. Docker Desktop & Docker Compose

Docker benötigt WSL, deshalb erst jetzt installieren.

choco install docker-desktop -y
choco install docker-compose -y

docker --version
docker-compose --version

Wichtig: Nach der Installation in Docker Desktop die WSL-Integration aktivieren: Docker Desktop → Settings → Resources → WSL Integration → Enable

---

Datenbank & Browser 🗄️

8. Azure Data Studio

Für Datenbankentwicklung und -verwaltung.

choco install azure-data-studio -y

azuredatastudio --version

9. Brave Browser

Ein schneller, datenschutzfreundlicher Browser für die Webentwicklung.

choco install brave -y
brave --version

---

Git Tools 🔀

10. GitHub Desktop

GUI für Git-Operationen (optional, wenn du lieber mit einer grafischen Oberfläche arbeitest).

choco install github-desktop -y

---

AI Tools 🤖

11. Claude Code

Claude als CLI-Tool für AI-gestützte Entwicklung.

choco install jq -y

irm https://claude.ai/install.ps1 | iex
claude --version

• https://github.com/ericbuess/claude-code-docs

Personal Preferences Claude Code: /memory

* in all interactions and commit messages, be extremely concise and sacrifice grammar for the sake of concision.

# PR Comments

<pr-comment-rule>
When I say to add a comment to a PR with a todo on it, use 'checkbox' markdown format to add the TODO. For instance:

<example>
- [ ] A description of the todo goes here.
</example>
</pr-commit-rule>

when Tagging claude in github issues, use '@claude'

# Plans

At the end of each plan, give me a list of unresolved Questions to answer, if any. Make the Questions extremely concise. Sacrifice Grammar for the sake of concision.

# Development Rules

- No code comments
- Show complete code sections
- Only show files requiring changes
- Server actions mandatory (no API routes)
- No styling implementation
- Shadcn UI (except cards)
- Package.json only on request
- Reusable functions go in lib/utils.ts or similar
- File name stated before each code block

# Tech Stack

- Next.js 15 (no API routes, just server actions)
- Drizzle ORM with PostgreSQL 17
- Golang for APIs
- Self-hosting (Coolify, VPS)

Slash Commands

commit

mkdir -p ~/.claude/commands
notepad ~/.claude/commands/commit.md

---
description: Analyze git changes, generate commit message, commit with interactive version/deploy
allowed-tools:
  - git
  - node
---

# Commit Command

Analyze git changes and commit with conventional commit message.

## Process

1. Run `git diff` to see all unstaged changes
2. Run `git status` to see file list
3. Analyze changes and generate conventional commit message
4. Show generated message and ask for confirmation
5. If approved: `git add . && git commit -m "[message]"`
6. Post-commit hook handles version bump and deploy prompts

## Commit Message Rules

- Format: `type: description`
- Types: feat, fix, docs, dx, style, refactor, test, chore, perf, revert, ci, typo, fun
- Description must be lowercase
- Be specific and meaningful about WHAT changed and WHY
- No period at end

## Examples

- `feat: add jwt authentication middleware`
- `fix: resolve memory leak in websocket handler`
- `refactor: extract database queries to separate service`
- `dx: improve error messages in api responses`

---

PowerShell Setup ⚙️

Dev-Ordner als Standard setzen & Git-Branches anzeigen

Mit Oh My Posh und posh-git siehst du den aktuellen Git-Branch direkt in der Konsole.

mkdir C:\dev
choco install oh-my-posh -y
notepad $PROFILE

Füge folgende Zeilen in dein PowerShell-Profil ein:

fnm env --use-on-cd | Out-String | Invoke-Expression
Import-Module posh-git

function c {
  clear;claude -dangerously-skip-permissions @args
}

function run{
  clear;npm run dev
}

function d{
  clear;code .; npm run dev
}

if ($env:TERM_PROGRAM -ne "vscode") {
    Set-Location C:\dev
}

function prompt {
    $currentPath = (Get-Location).Path
    $currentDir = Split-Path -Leaf $currentPath

    if ($currentPath -like "C:\dev\*" -or $currentPath -like "C:\dev-daniellechner\*") {
        $displayPath = $currentDir
    } else {
        $displayPath = $currentPath
    }

    $gitStatus = Get-GitStatus
    if ($gitStatus) {
        $gitPrompt = Write-VcsStatus $gitStatus
        "$displayPath $gitPrompt $ "
    } else {
        "$displayPath $ "
    }
}

---

Weitere nützliche Tools 🛠️

• Windhawk
  • Vertical Taskbar for Windows 11
  • Slick Window Arrangement
• Figma - Design & Prototyping
• Notion - Notizen & Projektmanagement

---

Wartung 🔄

Alle installierten Apps updaten

Mit einem Befehl alle Chocolatey-Pakete auf den neuesten Stand bringen:

choco upgrade all -y