<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-Gentoo</h3
<p align="center" The Gentoo OS-native layer — Portage, USE flags, source-based, over the shared Core. <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-Gentoo/issues/new?labels=bug"Report Bug</a · <a href="https://github.com/dotgibson/dotfiles-Gentoo/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-Gentoo is the OS-native layer for Gentoo — the capstone of the Linux set, and 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 Gentoo: Portage/emerge, full category/name atoms, USE flags, and the source-build mitigations.
Gentoo is stamped from the dotfiles-Fedora template per the [porting matrix][porting] — the most educational and most time-expensive of the set, since emerge compiles packages. 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
- [![Gentoo][gentoo-shield]][gentoo-url]
- [![Portage][portage-shield]][portage-url]
- [![eix][eix-shield]][eix-url]
<p align="right"(<a href="#readme-top"back to top</a)</p