dempfi · zimya · Jul 14, 2017 · Jul 20, 2017 · Jul 25, 2017 · Sep 14, 2017
diff --git a/.supports-a-file-icon-customization b/.supports-a-file-icon-customization
diff --git a/Default.sublime-commands b/Default.sublime-commands
@@ -0,0 +1,6 @@
+[
+  {
+    "caption": "ayu: Activate theme",
+    "command": "ayu_activate"
+  }
+]
diff --git a/Icons.py b/Icons.py
@@ -0,0 +1,80 @@
+"""
+A File Icon Installer
+"""
+
+import os
+import sublime
+
+ICONS_PACKAGE = "A File Icon"
+PKGCTRL_SETTINGS = "Package Control.sublime-settings"
+
+THEME_NAME = os.path.splitext(
+    os.path.basename(os.path.dirname(__file__))
+)[0]
+
+MSG = """\
+<div id="afi-installer">
+  <style>
+    #afi-installer {{
+      padding: 1rem;
+      line-height: 1.5;
+    }}
+    #afi-installer code {{
+      background-color: color(var(--background) blend(var(--foreground) 80%));
+      line-height: 1;
+      padding: 0.25rem;
+    }}
+    #afi-installer a {{
+      padding: 0;
+      margin: 0;
+    }}
+  </style>
+
+  {} requires <code>A File Icon</code> package for enhanced<br>support of
+  the file-specific icons.
+  <br><br>Would you like to install it?<br>
+  <br><a href="install">Install</a> <a href="cancel">Cancel</a>
+</div>
+""".format(THEME_NAME)
+
+
+def is_installed():
+    pkgctrl_settings = sublime.load_settings(PKGCTRL_SETTINGS)
+
+    return ICONS_PACKAGE in set(pkgctrl_settings.get("installed_packages", []))
+
+
+def on_navigate(href):
+    if href.startswith("install"):
+        install()
+    else:
+        hide()
+
+
+def install():
+    print("Installing `{}` ...".format(ICONS_PACKAGE))
+    sublime.active_window().run_command(
+        "advanced_install_package", {"packages": ICONS_PACKAGE}
+    )
+    hide()
+
+
+def hide():
+    sublime.active_window().active_view().hide_popup()
+
+
+def plugin_loaded():
+    from package_control import events
+
+    if events.install(THEME_NAME) and not is_installed():
+        window = sublime.active_window()
+        view = window.active_view()
+        window.focus_view(view)
+        row = int(view.rowcol(view.visible_region().a)[0] + 1)
+        view.show_popup(
+            MSG,
+            location=view.text_point(row, 5),
+            max_width=800,
+            max_height=800,
+            on_navigate=on_navigate
+        )
diff --git a/Preferences.sublime-settings b/Preferences.sublime-settings
@@ -0,0 +1,10 @@
+{
+    // ayu theme: Use native titlebars on macOs
+    "ui_native_titlebar": false,
+
+    // ayu theme: Show separators between panels
+    "ui_separator": false,
+
+    // ayu theme: Display wider scrollbars
+    "ui_wide_scrollbars": false
+}
diff --git a/README.md b/README.md
@@ -1,99 +1,156 @@
-![ayu](http://i.imgur.com/b3etBQX.png)
+![ayu](./images/hero.png)
 
 `ayu` is a simple theme with bright colors and comes in three versions — *dark*, *mirage* and *light* for all day long comfortable work.
 
-# Font
+> All screenshots use wonderful [Pragmata Pro](https://fsd.it/shop/fonts/pragmatapro/) font
 
-`ayu` uses [__Roboto Mono__](https://www.google.com/fonts/specimen/Roboto+Mono) as main font and it's highly recommended to install it to get monospaced font in filetree. But if you don't have it then the UI theme will downgrade to standard UI font used in Sublime Text.
+### File Icons
 
-# Screenshots
+`ayu` from version `3.0.0` supports customization via [A File Icon](https://github.com/SublimeText/AFileIcon) package. Please install it and restart Sublime for better experience.
 
-Light with `ui_separator` option on
-![Light with separators on](http://i.imgur.com/AJbChTB.png)
+### Custom UI fonts
 
-🎉**NEW**🎉 Mirage with `ui_separator` option off
-![Mirage with separators off](http://i.imgur.com/3kkWv8k.png)
+Since verion `5.0.0` monospaced fonts options were removed. But it's still possible to use your favourite font in the
+user interface of the theme, just follow through these simple steps:
 
-Dark with `ui_separator` option on
-![Dark with separators on](http://i.imgur.com/bbH1K5O.png)
+![ayu mono](./images/browse.png)
 
-# Settings
+1. Pull up command pallete via <kbd>cmd/ctrl</kbd> + <kbd>shift</kbd> + <kbd>p</kbd>
+2. Type in `Browse packages`
+3. Navigate to the `/User` folder
+4. Create a file named `ayu-mirage.sublime-theme` to modify mirage or `ayu-light.sublime-theme` and `ayu-dark.sublime-theme`
+5. Open that file in Sublime
+6. Copy and paste following content:
+   ```json
+   [
+     {
+       "class": "sidebar_label",
+       "font.face": "PragmataPro Mono Liga"
+     },
+     {
+       "class": "sidebar_heading",
+       "font.face": "PragmataPro Mono Liga"
+     },
+     {
+       "class": "tab_label",
+       "font.face": "PragmataPro Mono Liga"
+     },
+     {
+       "class": "label_control",
+       "font.face": "PragmataPro Mono Liga"
+     },
+     {
+       "class": "quick_panel_label",
+       "font.face": "PragmataPro Mono Liga"
+     },
+     {
+       "class": "quick_panel_path_label",
+       "font.face": "PragmataPro Mono Liga"
+     }
+   ]
+   ```
+7. Replace `PragmataPro Mono Liga` with the font of your choice
+8. Save and enjoy :)
 
-```json
+### Screenshots
+
+<h6 align='center'>Light with <code>ui_separator</code> option on</h6>
+
+![Light](images/light-separator.png)
+
+---
+
+
+<h6 align='center'>Mirage with <code>ui_separator</code> option off</h6>
+
+![Mirage](images/mirage-no-separator.png)
+
+---
+
+<h6 align='center'>Dark with <code>ui_separator</code> option on</h6>
+
+![Dark](images/dark-separator.png)
+
+### Settings
+
+```js
+"ui_native_titlebar":       true, // use native titlebars on macOs
 "ui_separator":             true, // separators between panels
-"ui_font_size_small":       true, // smaller UI font size(sidebar, statusbar etc)
-"ui_big_tabs":              true, // increased tab height
-"ui_fix_tab_labels":        true, // to fix tab labels if they look not right
-"ui_font_source_code_pro": true, // use [Source Code Pro](https://fonts.google.com/specimen/Source+Code+Pro) for UI
-"ui_wide_scrollbars":  true,  // wider scrollbars
-"ui_sidebar_highlight_row": true // to highlight whole row for current item in sidebar
+"ui_wide_scrollbars":       true, // wider scrollbars
 ```
 
-# Installation
+---
+
+### Installation
+
+###### Recommended
 
 You can install `ayu` via [Package Control](https://packagecontrol.io/).
 
 1. Press <kbd>cmd/ctrl</kbd> + <kbd>shift</kbd> + <kbd>p</kbd> to open the command palette.
 2. Type `install package` and press enter. Then search for `ayu`
 
-# Manual installation
+###### Manual
 
 1. Download the [latest release](https://github.com/dempfi/ayu/releases/latest), extract and rename the directory to `ayu`.
 2. Move the directory inside your sublime `/Packages` directory. *(Preferences > Browse packages...)*
 
-# Activation
-## Sublime Text 3
-### Skins package
+---
+
+### Activation
+
+###### Recommended
+
+Open command palette via `Tools > Command Palette` (or <kbd>cmd/ctrl</kbd> + <kbd>shift</kbd> + <kbd>p</kbd>) and type `ayu: Activate theme`.
+
+
+###### With Skins package
+
 [Skins](https://packagecontrol.io/packages/Skins) provides a simple and efficient way to change themes, save your own presets and quickly try out new looks. Activation is as simple as opening up the command palette, running `Select Skin` and choosing `Ayu - Dark` or `Ayu - Light` from the list.
 
-### Normal way
+
+###### Via Preferences
+
 Add these lines to your user settings *Preferences > Setting - User*:
 
 For light theme:
-```json
+
+```js
 "theme": "ayu-light.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-light.tmTheme",
+"color_scheme": "Packages/ayu/ayu-light.sublime-color-scheme",
 ```
 
 For mirage theme:
-```json
+
+```js
 "theme": "ayu-mirage.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-mirage.tmTheme",
+"color_scheme": "Packages/ayu/ayu-mirage.sublime-color-scheme",
 ```
 
 For dark theme:
-```json
-"theme": "ayu-dark.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-dark.tmTheme",
-```
-
-## Sublime Text 2
-Add this lines to your user settings *Preferences > Setting - User*:
 
-_Sublime Text 2 version may have some glitches, if you notice something, please file an issue._
-
-For light theme:
-```json
-"theme": "ayu-light2.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-light.tmTheme",
+```js
+"theme": "ayu-dark.sublime-theme",
+"color_scheme": "Packages/ayu/ayu-dark.sublime-color-scheme",
 ```
 
-For mirage theme:
-```json
-"theme": "ayu-mirage2.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-mirage.tmTheme",
-```
+### Sublime Text 3
+ayu no longer supports Sublime Text 3. But you still can download
+and install manually [latest supported version](https://github.com/dempfi/ayu/releases/tag/v5.1.0).
 
-For dark theme:
-```json
-"theme": "ayu-dark2.sublime-theme",
-"color_scheme": "Packages/ayu/ayu-dark.tmTheme",
-```
+### Sublime Text 2
 
-**NOTE:** Restart Sublime Text after activation of the theme to avoid any glitches.
+ayu no longer supports Sublime Text 2. But you still can download
+and install manually [latest supported version](https://github.com/dempfi/ayu/releases/tag/3.2.2).
 
-# Others
+### Related projects and ports
 
 - `ayu` for Ace: https://github.com/ayu-theme/ayu-ace
 - `ayu` colors as NPM package: https://github.com/ayu-theme/ayu-colors
 - `ayu` for VSCode: https://github.com/teabyii/vscode-ayu
+- `ayu` for XCode: https://github.com/vburojevic/ayu-xcode-theme
+- `ayu` for [Kakoune](https://github.com/mawww/kakoune): https://github.com/icantjuddle/ayu-kak
+
+<div align="right"><sup>
+  made with ❤️ by <a href="https://github.com/dempfi">@dempfi</a>
+</sup></div>