Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/5ouma/dotfiles

⚙ The most minimal and powerful dotfiles ever
https://github.com/5ouma/dotfiles

dotfiles homebrew linux mac vim zsh

Last synced: 28 days ago
JSON representation

⚙ The most minimal and powerful dotfiles ever

Awesome Lists containing this project

README

        






header

**⚙ The most minimal and powerful dotfiles ever**

My config files and setup for CLI tools and GUI apps.

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/5ouma/dotfiles?style=flat-square)
![GitHub repo size](https://img.shields.io/github/repo-size/5ouma/dotfiles?style=flat-square)
[![GitHub last commit](https://img.shields.io/github/last-commit/5ouma/dotfiles?style=flat-square)](https://github.com/5ouma/dotfiles/commit/HEAD)
[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/5ouma/dotfiles?style=flat-square)](https://github.com/5ouma/dotfiles/commits/main)


[![Test](https://img.shields.io/github/actions/workflow/status/5ouma/dotfiles/test.yml?label=test&style=flat-square)](https://github.com/5ouma/dotfiles/actions/workflows/test.yml)
[![Detail Test](https://img.shields.io/github/actions/workflow/status/5ouma/dotfiles/detail-test.yml?label=detail%20test&style=flat-square)](https://github.com/5ouma/dotfiles/actions/workflows/detail-test.yml)



## 🔐 Requirements

- ### 🍎 macOS

- **macOS** Sonoma `Version 14` or later
- Apple Silicon Mac

- ### 🐧 Linux

> ⚠️ Experimental Support

- cURL, Git, and Zsh to run the [setup](../setup)
- Compatible with these [Homebrew dependencies](https://docs.brew.sh/Homebrew-on-Linux#requirements)



## 📥 Installation

Run one line [setup](../setup), see the [usage](#-usage) for the detail.


> _All configurations_
>
> ```sh
> zsh <(curl https://dotup.deno.dev)
> ```


> _Just config files_
>
> ```sh
> zsh <(curl https://dotup.deno.dev) set
> ```


> _Vim config files_
>
> ```sh
> curl https://vimrc.deno.dev > "$HOME/.config/vim/vimrc"
> ```



## 📊 Usage

### `setup help`

```sh
▌ Usage: setup

│ ⚙️ The most minimal and powerful dotfiles ever.

▌ Commands:

• help Print help information
• set Set files to home directory

▌ Flags:

• -y, --yes Start without confirmation
```



## 🌄 Screenshots

| | Overview | Vim |
| :--------: | :---------------------: | :------------------------------------: |
| Light Mode | ![Overview - Light] | ![Vim - Light] |
| Dark Mode | ![Overview - Dark] | ![Vim - Dark] |
| Tools | [fastfetch], [Amazon Q] | [lightline.vim], [NERDTree], [fzf.vim] |

[Overview - Light]: ./images/screenshots/light/overview.png
[Overview - Dark]: ./images/screenshots/dark/overview.png
[Vim - Light]: ./images/screenshots/light/vim.png
[Vim - Dark]: ./images/screenshots/dark/vim.png
[fastfetch]: https://github.com/fastfetch-cli/fastfetch
[Amazon Q]: https://aws.amazon.com/q/developer
[lightline.vim]: https://github.com/itchyny/lightline.vim
[NERDTree]: https://github.com/preservim/nerdtree
[fzf.vim]: https://github.com/junegunn/fzf.vim



## 📝 Details

- ### 🍺 Package Manager: [`Homebrew`](https://brew.sh)

```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

> See packages in **[`Brewfile`]**
> or on **[`Shell Commands`]**, **[`Software`]**, **[`Fonts`]** _(GitHub Star List)_

[`Brewfile`]: ../data/Brewfile
[`Shell Commands`]: https://github.com/stars/5ouma/lists/shell-commands
[`Software`]: https://github.com/stars/5ouma/lists/software
[`Fonts`]: https://github.com/stars/5ouma/lists/fonts


- ### 📼 Runtime Manager: [`mise`](https://github.com/jdx/mise)

```sh
brew install mise
```


- ### 📺 Terminal: [`iTerm2`](https://iterm2.com)

```sh
brew install iterm2
```

- #### 🖋 Font 1: [`Fira Code`](https://github.com/tonsky/FiraCode)

```sh
brew install font-fira-code
```

- #### ✒️ Font 2: [`HackGen35`](https://github.com/yuru7/hackgen)

```sh
brew install font-hackgen font-hackgen-nerd
```

- #### 🧠 Terminal Autocompletion: [`Amazon Q`](https://aws.amazon.com/q/developer)

> _Formally [Fig](https://fig.io)_

```sh
brew install amazon-q
```


- ### 🐚 Shell: [`Zsh`](https://zsh.org)

- #### 🔌 Plugin Manager: [`Sheldon`](https://github.com/rossmacarthur/sheldon)

```sh
brew install sheldon
```

> See plugins in **[`plugins.toml`]**
> or on **[`Zsh Plugins`]** _(GitHub Star List)_

[`plugins.toml`]: ../config/sheldon/.config/sheldon/plugins.toml
[`Zsh Plugins`]: https://github.com/stars/5ouma/lists/zsh-plugins

- #### ❯ Theme: [`Powerlevel10k`](https://github.com/romkatv/powerlevel10k)

```sh
sheldon add powerlevel10k --github romkatv/powerlevel10k --apply source
```


- ### 🖌 Terminal Editor: [`Vim`](https://www.vim.org)

- #### 🚀 Plugin Manager: [`Jetpack`](https://github.com/5ouma/vim-jetpack)

```sh
curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}/vim/pack/jetpack/opt/vim-jetpack/plugin/jetpack.vim" --create-dirs https://raw.githubusercontent.com/tani/vim-jetpack/master/plugin/jetpack.vim
```

> See plugins in **[`plugins.vim`]**
> or on **[`Vim Plugins`]** _(GitHub Star List)_

[`plugins.vim`]: ../config/vim/.config/vim/plugins.vim
[`Vim Plugins`]: https://github.com/stars/5ouma/lists/vim-plugins

- #### ✏️ Color Scheme: [`Pencil`](https://github.com/5ouma/vim-colors-pencil)

- #### 💾 LSP: [`vim-lsp`](https://github.com/prabirshrestha/vim-lsp)



## 🎨 ANSI Colors

| \ | Normal | Bright |
| :-----: | :------------------: | :------------------: |
| Black | ![#000000] `#000000` | ![#686868] `#686868` |
| Red | ![#C51E14] `#C51E14` | ![#FD6F6B] `#FD6F6B` |
| Green | ![#1DC121] `#1DC121` | ![#67F86F] `#67F86F` |
| Yellow | ![#C7C329] `#C7C329` | ![#FFFA72] `#FFFA72` |
| Blue | ![#0A2FC4] `#0A2FC4` | ![#6A76FB] `#6A76FB` |
| Magenta | ![#C839C5] `#C839C5` | ![#FD7CFC] `#FD7CFC` |
| Cyan | ![#20C5C6] `#20C5C6` | ![#68FDFE] `#68FDFE` |
| White | ![#C7C7C7] `#C7C7C7` | ![#FFFFFF] `#FFFFFF` |

[#000000]: https://via.placeholder.com/15/000000/000000.png
[#686868]: https://via.placeholder.com/15/686868/686868.png
[#C51E14]: https://via.placeholder.com/15/C51E14/C51E14.png
[#FD6F6B]: https://via.placeholder.com/15/FD6F6B/FD6F6B.png
[#1DC121]: https://via.placeholder.com/15/1DC121/1DC121.png
[#67F86F]: https://via.placeholder.com/15/67F86F/67F86F.png
[#C7C329]: https://via.placeholder.com/15/C7C329/C7C329.png
[#FFFA72]: https://via.placeholder.com/15/FFFA72/FFFA72.png
[#0A2FC4]: https://via.placeholder.com/15/0A2FC4/0A2FC4.png
[#6A76FB]: https://via.placeholder.com/15/6A76FB/6A76FB.png
[#C839C5]: https://via.placeholder.com/15/C839C5/C839C5.png
[#FD7CFC]: https://via.placeholder.com/15/FD7CFC/FD7CFC.png
[#20C5C6]: https://via.placeholder.com/15/20C5C6/20C5C6.png
[#68FDFE]: https://via.placeholder.com/15/68FDFE/68FDFE.png
[#C7C7C7]: https://via.placeholder.com/15/C7C7C7/C7C7C7.png
[#FFFFFF]: https://via.placeholder.com/15/FFFFFF/FFFFFF.png