<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-Alpine</h3
<p align="center" The Alpine OS-native layer — musl, apk, doas; the lean container / rescue box. <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-Alpine/issues/new?labels=bug"Report Bug</a · <a href="https://github.com/dotgibson/dotfiles-Alpine/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="#whats-in-this-layer"What's In This Layer</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-Alpine is the OS-native layer for Alpine Linux — one node in a cross-platform dotfiles system. The shared Core (zsh, tmux, Neovim, git, starship, mise) is authored once in dotfiles-core and vendored under core/ via git subtree, so a clone is self-contained. This repo adds only what is genuinely Alpine: apk, doas, and the musl-aware build/install choices.
Alpine is stamped from the dotfiles-Fedora template per the [porting matrix][porting], but it is the outlier of the set — musl instead of glibc — so more diverges here than on the other stamps. This is the lean container / rescue-disk box; keep its layer small. The full docs live on the [documentation site][docs].
The system is three layers, each building on the one below:
| Layer | Lives in | Owns | | ------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | | Core | dotfiles-core → vendored into every OS repo's core/ | zsh, tmux, nvim, git, starship — identical everywhere | | OS-native | dotfiles-{MacBook,Windows,Fedora,Arch,Debian,openSUSE,Alpine,Gentoo} (this repo among them) | package manager, clipboard, paths | | Role | dotfiles-Offense, dotfiles-Defense | offensive / defensive tooling |
Languages
No new languages — this layer is shell and package config over Core's language stack.
Tools
- [![Alpine Linux][alpine-shield]][alpine-url]
- [![apk][apk-shield]][apk-url]
- [![musl][musl-shield]][musl-url]
- [![BusyBox][busybox-shield]][busybox-url]
- [![doas][doas-shield]][doas-url]
<p align="right"(<a href="#readme-top"back to top</a)</p