<a id="readme-top"</a
<div align="center"<nobr
--[![CI][ci-shield]][ci-url]<!-- --![Last Commit][lastcommit-shield]<!-- --[![Contributors][contributors-shield]][contributors-url]<!-- --[![Forks][forks-shield]][forks-url]<!-- --[![Stargazers][stars-shield]][stars-url]<!-- --[![Issues][issues-shield]][issues-url]<!-- --[![MIT License][license-shield]][license-url]
</nobr</div
<br / <div align="center" <a href="https://github.com/dotgibson/" <img src="https://raw.githubusercontent.com/dotgibson/.github/main/profile/logo.png" alt="Logo" width="80" height="80" </a
<h3 align="center"🪟 dotfiles-Windows</h3
<p align="center" The native Windows host — PowerShell, Windows Terminal, scoop/winget, and the WSL2 bridge. <br / <a href="https://dotgibson.github.io/dotfiles-web/docs"<strongExplore the docs »</strong</a <br / <br / <a href="https://dotgibson.github.io/dotfiles-web/playground/"View Demo</a · <a href="https://github.com/dotgibson/dotfiles-Windows/issues/new?labels=bug"Report Bug</a · <a href="https://github.com/dotgibson/dotfiles-Windows/issues/new?labels=enhancement"Request Feature</a </p </div
<details <summaryTable of Contents</summary <ol <li <a href="#about-the-project"About The Project</a <ul <li<a href="#languages"Languages</a</li <li<a href="#tools"Tools</a</li </ul </li <li<a href="#getting-started"Getting Started</a</li <li<a href="#layout"Layout</a</li <li<a href="#contributing"Contributing</a</li <li<a href="#license"License</a</li <li<a href="#contact"Contact</a</li </ol </details
About The Project
dotfiles-Windows is the native-host layer — one node in a cross-platform dotfiles system. It owns the Windows host: PowerShell 7 as the daily-driver shell, Windows Terminal, the scoop/winget package layer, psmux (native tmux), and the bridge into Linux distros running under WSL2.
Unlike every OS repo, Windows does not vendor Core as a git subtree. The shared config is replicated natively in PowerShell — the powershell/core/ fragments mirror the feel of the zsh loader — so only three cross-shell assets are vendored: nvim/ from dotfiles-nvim (via nvim-sync.ps1, pinned in nvim.lock), and starship/starship.toml plus theme/palette.toml from dotfiles-core (via starship-sync.ps1 and theme-sync.ps1, the latter then rendered into the terminal layer by gen-theme.ps1). The editor comes from its own repo because that is where it is authored — dotfiles-core vendors the very same release, so this host is a first-class consumer of the editor's release line rather than a mirror of somebody else's copy of it. It also deliberately does not configure WSL distros — Core, dotfiles-Debian and dotfiles-Offense configure themselves from their own repos inside WSL. This repo makes the host excellent, then gets out of the way. Full docs live on the [documentation site][docs].
The system is three layers; Windows is a host that replicates Core rather than vendoring it:
| Layer | Lives in | Owns | | --- | --- | --- | | Core | dotfiles-core → vendored into every OS repo's core/ (Windows replicates it in pwsh instead) | zsh, tmux, nvim, git, starship — identical everywhere | | OS-native | dotfiles-{MacBook,Windows,Fedora,Arch,Debian,openSUSE,Alpine,Gentoo} (Windows is the native host) | package manager, clipboard, paths | | Role | dotfiles-Offense, dotfiles-Defense | offensive / defensive tooling (Windows bridges to Kali under WSL) |
Languages
- [![PowerShell][powershell-shield]][powershell-url]
Tools
- [![Windows Terminal][wt-shield]][wt-url]
- [![Scoop][scoop-shield]][scoop-url]
- [![WinGet][winget-shield]][winget-url]
- [![psmux][psmux-shield]][psmux-url]
<p align="right"(<a href="#readme-top"back to top</a)</p