let's do this

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "yonce-vscode"]
+	path = yonce-vscode
+	url = [email protected]:minamarkham/yonce-vscode.git

README.md

@@ -1,2 +1,75 @@
-# yonce
-👑 A Bash prompt fit for a Queen
+<div align="center" style="text-align: center;">
+
+![logo](./assets/logo.png)
+
+A Queen Bey inspired theme for [Bash-It](https://github.com/Bash-it/bash-it), [Visual Studio Code](http://code.visualstudio.com/), [iTerm](http://www.iterm2.com/), [Slack](http://slack.com/) & [Alfred](https://alfredapp.com)
+
+</div>
+
+## Bash
+![Yoncé Bash Theme](./assets/bash.gif)
+
+_In order for this theme to render correctly, you will need a [Nerd Fonts-patched font](https://github.com/ryanoasis/nerd-fonts). Demo uses patched version of [Dank Mono](http://dank.sh)._
+
+### Activating
+
+1. Move [`yonce.theme.bash`](yonce.theme.bash) file to [bash-it](https://github.com/Bash-it/bash-it)'s theme folder: `.bash_it/themes/yonce/`.
+2. Go to your `~/.bash_profile` file and set `BASH_IT_THEME="yonce"`.
+3. Finally, reload your terminal.
+
+_[Bash-it theme documentation](https://github.com/Bash-it/bash-it#themes)_
+
+---
+
+## Visual Studio Code
+![VSCode Preview](./assets/vscode.jpg)
+
+1. Install using Command Palette
+2. Go to View -> Command Palette or press <kbd>⌘</kbd><kbd>Shift</kbd><kbd>P</kbd> / <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>P</kbd>
+3. Then enter Install Extension
+4. Write `yonce-theme`
+5. Select it or press Enter to install
+
+---
+
+## iTerm
+
+![iTerm Preview](./assets/iterm.jpg)
+
+### Activating
+
+1. iTerm2 → `Preferences` → `Profiles` → `Colors` Tab
+2. Click `Load Presets...`
+3. Click `Import...`
+4. Select the [`Yoncé.itermcolors`](Yoncé.itermcolors) file
+5. Select the `Yoncé` from `Load Presets...`
+
+**Note: Yoncé.itermcolors reflects only the theme colors in iTerm. To get the formatting and glyphs shown, you will need to configure your Bash theme via the instructions above.**
+
+---
+
+## Slack
+
+![Slack Preview](./assets/slack.jpg)
+
+### Activating
+
+1. Open Preferences by clicking on your workspace name
+2. Select Sidebar
+3. Click the “customize your theme and share it with others” link
+4. Paste `#121212,#2F2F2F,#FC4384,#FFFFFF,#00A7AA,#FFFFFF,#37E5E7,#A06FCA`
+5. Click `X` button in upper right.
+
+---
+
+## Alfred
+
+![Alfred Preview](./assets/alfred.jpg)
+
+### Activating
+
+Double-click on [`Yoncé.alfredappearance`](Yoncé.alfredappearance).
+
+## Credits
+
+* Background Photo by [Ruvim Noga](https://unsplash.com/photos/pazM9TQJ2Ck) on [Unsplash](https://unsplash.com/@ruvimnogaphoto)

Yoncé.alfredappearance

@@ -0,0 +1,61 @@
+{
+  "alfredtheme" : {
+    "result" : {
+      "textSpacing" : 4,
+      "subtext" : {
+        "size" : 11,
+        "colorSelected" : "#BABABAFF",
+        "font" : "System Light",
+        "color" : "#7F7F7FFF"
+      },
+      "shortcut" : {
+        "size" : 16,
+        "colorSelected" : "#98E341FF",
+        "font" : "System Light",
+        "color" : "#00A7AAFF"
+      },
+      "backgroundSelected" : "#3333337F",
+      "text" : {
+        "size" : 16,
+        "colorSelected" : "#F1F1EFFF",
+        "font" : "System Light",
+        "color" : "#F1F1EFFF"
+      },
+      "iconPaddingHorizontal" : 5,
+      "paddingVertical" : 4,
+      "iconSize" : 40
+    },
+    "search" : {
+      "paddingVertical" : 2,
+      "background" : "#1C1C1C00",
+      "spacing" : 10,
+      "text" : {
+        "size" : 32,
+        "colorSelected" : "#000000FF",
+        "font" : "System Light",
+        "color" : "#FC4383FF"
+      },
+      "backgroundSelected" : "#B2D7FFFF"
+    },
+    "window" : {
+      "color" : "#1C1C1CE5",
+      "paddingHorizontal" : 10,
+      "width" : 560,
+      "borderPadding" : 10,
+      "borderColor" : "#1C1C1C00",
+      "blur" : 0,
+      "roundness" : 3,
+      "paddingVertical" : 10
+    },
+    "credit" : "Mina Markham",
+    "separator" : {
+      "color" : "#00000000",
+      "thickness" : 1
+    },
+    "scrollbar" : {
+      "color" : "#00000026",
+      "thickness" : 2
+    },
+    "name" : "Yoncé"
+  }
+}