☁️ chore(automation): Automated update

.vscode/tasks.json

@@ -281,21 +281,6 @@
       "type": "shell",
       "command": "bash start.sh && task get:links"
     },
-    {
-      "label": "(git:filter): Remove large unnecessary and large files from the repository",
-      "type": "shell",
-      "command": "bash start.sh && task git:filter"
-    },
-    {
-      "label": "(git:remotes): Configure the the `origin`, `gitlab`, `github`, and `all` git remotes",
-      "type": "shell",
-      "command": "bash start.sh && task git:remotes"
-    },
-    {
-      "label": "(git:remove:submodules): Remove all submodules in the current directory and optionally filter by RegEx",
-      "type": "shell",
-      "command": "bash start.sh && task git:remove:submodules"
-    },
     {
       "label": "(go:test:convey): Run tests through the browser with GoConvey",
       "type": "shell",

LICENSE

@@ -20,5 +20,5 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-GitHub: https://github.com/megabyte-labs/hiawatha-dotfiles
+GitHub: https://github.com/megabyte-labs/sexy-start
-GitLab: https://gitlab.com/megabyte-labs/hiawatha-dotfiles
+GitLab: https://gitlab.com/megabyte-labs/sexy-start

README.md

@@ -1,12 +1,12 @@
 <!-- ⚠️ This README has been generated from the file(s) ".config/docs/blueprint-readme-misc.md" ⚠️--><div align="center">
   <center>
-    <a href="https://github.com/megabyte-labs/hiawatha-dotfiles">
+    <a href="https://github.com/megabyte-labs/sexy-start">
-      <img width="148" height="148" alt="Hiawatha Dotfiles logo" src="https://gitlab.com/megabyte-labs/hiawatha-dotfiles/-/raw/master/logo.png" />
+      <img width="148" height="148" alt="Sexy Start logo" src="https://gitlab.com/megabyte-labs/sexy-start/-/raw/master/logo.png" />
     </a>
   </center>
 </div>
 <div align="center">
-  <center><h1 align="center"><i></i>Hiawatha Dotfiles - The Spirit of GitHub<i></i></h1></center>
+  <center><h1 align="center"><i></i>Cross-Platform Sexy Start<i></i></h1></center>
   <center><h4 style="color: #18c3d1;">Maintained by <a href="https://megabyte.space" target="_blank">Megabyte Labs</a></h4><i></i></center>
 </div>
 
@@ -14,7 +14,7 @@
   <a href="https://megabyte.space" title="Megabyte Labs homepage" target="_blank">
     <img alt="Homepage" src="https://img.shields.io/website?down_color=%23FF4136&down_message=Down&label=Homepage&logo=home-assistant&logoColor=white&up_color=%232ECC40&up_message=Up&url=https%3A%2F%2Fmegabyte.space&style=for-the-badge" />
   </a>
-  <a href="https://github.com/megabyte-labs/hiawatha-dotfiles/blob/master/docs/CONTRIBUTING.md" title="Learn about contributing" target="_blank">
+  <a href="https://github.com/megabyte-labs/sexy-start/blob/master/docs/CONTRIBUTING.md" title="Learn about contributing" target="_blank">
     <img alt="Contributing" src="https://img.shields.io/badge/Contributing-Guide-0074D9?logo=github-sponsors&logoColor=white&style=for-the-badge" />
   </a>
   <a href="https://app.slack.com/client/T01ABCG4NK1/C01NN74H0LW/details/" title="Chat with us on Slack" target="_blank">
@@ -23,54 +23,141 @@
   <a href="https://gitter.im/megabyte-labs/community" title="Chat with the community on Gitter" target="_blank">
     <img alt="Gitter" src="https://img.shields.io/gitter/room/megabyte-labs/community?logo=gitter&logoColor=white&style=for-the-badge" />
   </a>
-  <a href="https://github.com/megabyte-labs/hiawatha-dotfiles" title="GitHub mirror" target="_blank">
+  <a href="https://github.com/megabyte-labs/sexy-start" title="GitHub mirror" target="_blank">
     <img alt="GitHub" src="https://img.shields.io/badge/Mirror-GitHub-333333?logo=github&style=for-the-badge" />
   </a>
-  <a href="https://gitlab.com/megabyte-labs/hiawatha-dotfiles" title="GitLab repository" target="_blank">
+  <a href="https://gitlab.com/megabyte-labs/sexy-start" title="GitLab repository" target="_blank">
     <img alt="GitLab" src="https://img.shields.io/badge/Repo-GitLab-fc6d26?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgAQMAAABJtOi3AAAABlBMVEUAAAD///+l2Z/dAAAAAXRSTlMAQObYZgAAAHJJREFUCNdNxKENwzAQQNEfWU1ZPUF1cxR5lYxQqQMkLEsUdIxCM7PMkMgLGB6wopxkYvAeI0xdHkqXgCLL0Beiqy2CmUIdeYs+WioqVF9C6/RlZvblRNZD8etRuKe843KKkBPw2azX13r+rdvPctEaFi4NVzAN2FhJMQAAAABJRU5ErkJggg==&style=for-the-badge" />
   </a>
 </div>
 
-> </br><h4 align="center">**A glorious combination of application settings, theme files, and a performant cross-platform, desktop-oriented software installer.**</h4></br>
+> </br><h4 align="center">**A glorious combination of application / theme settings and a performant cross-platform, desktop-oriented software suite.**</h4></br>
 
 <a href="#table-of-contents" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
 
 ## Table of Contents
 
-    * [Overview](#overview)
+- [Overview](#overview)
-
+- [Quick Start](#quick-start)
-- [}Hiawatha](#hiawatha)
+  - [Quick Start Notes](#quick-start-notes)
-  - [Contributing](#contributing)
+- [Chezmoi-Based](#chezmoi-based)
-    - [Affiliates](#affiliates)
+- [Security Focused](#security-focused)
-  - [License](#license)
+- [Cross-Platform](#cross-platform)
+  - [Custom Software Provisioning System](#custom-software-provisioning-system)
+  - [Beautiful Anywhere](#beautiful-anywhere)
+  - [Qubes Support](#qubes-support)
+- [Gas Station](#gas-station)
+- [Chezmoi](#chezmoi)
+  - [Resetting Chezmoi](#resetting-chezmoi)
+- [Contributing](#contributing)
+  - [Affiliates](#affiliates)
+- [License](#license)
 
 <a href="#overview" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
 
 ## Overview
 
-Hiawatha Dotfiles is a glorious combination of application settings, theme files, and a performant yet flexible software installer written with [ZX](https://github.com/google/zx). The installer supports almost any operating system, just checkout the [software.yml file](https://gitlab.com/megabyte-labs/hiawatha-dotfiles/-/blob/master/software.yml). It uses [Chezmoi](https://github.com/twpayne/chezmoi) to apply file changes in an interactive way. It is not your typical Chezmoi project - it is built around the philosophy that you should be able to bash all your computers to bits with a hammer and then resurrect them the next day ✝️️ by storing stateful data to an S3 bucket and automating desktop configuration as much as possible.
+Want to try out a new desktop jam-packed with a whole suite of GitHub's most-starred projects? Betelgeuse is a combination of application settings, theme files, and a performant yet flexible software installer written with [ZX](https://github.com/google/zx). It is easily customizable, with optional prompts that ask you for API keys if you want to completely automate everything. The installer supports almost any operating system, just checkout the [software.yml file](https://gitlab.com/megabyte-labs/hiawatha-dotfiles/-/blob/master/software.yml). It uses [Chezmoi](https://github.com/twpayne/chezmoi) to apply file changes in an interactive way. It is not your typical Chezmoi project - it is built around the philosophy that you should be able to bash all your computers to bits with a hammer and then resurrect them the next day ✝️️ by storing stateful data to an encrypted S3 bucket and automating desktop configuration as much as possible.
 
-<a href="#hiawatha" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+Sexy Start is a cross-platform development environment provisioning system. The project began as an ongoing Ansible project named [Gas Station](https://github.com/megabyte-labs/gas-station) but transitioned to a dotfile-ish approach for easier adoption and less overhead. It is intended for:
 
-# }Hiawatha
+1. Power users that want to maximize their long-term efficiency by incorporating the [most-starred applications / projects / CLIs on GitHub](https://stars.megabyte.space) into their stack.
+2. Users that distro hop but want to retain their favorite tools regardless of whether they are using macOS, Windows, or Linux
+3. People that want to reformat their computers on a, perhaps, daily basis while retaining stateful elements of their file system by leveraging S3 buckets
+4. Enthusiasts that want to deploy as many cool, useful tools as possible without having to spend much time configuring their file system
+5. Perfectionists that love software that behaives as it should, looks gorgeous (desktop preview screenshots below), and performs tasks quickly on any platform
+6. CLI ninjas that want to bring their set of tools wherever they go
 
-This is a decked out dotfiles repository that leverages a handful of technologies including Chezmoi, Ansible, and ZX to provision computers. It is built to support Archlinux, Fedora, CentOS, Debian, Ubuntu, macOS, and Windows but you may see code that suggests other OSes will be supported as well. It includes themeing (most of the credit going to [Sweet](https://github.com/EliverLara/Sweet)) for KDE / GNOME / apps.
+<a href="#quick-start" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
 
-To use these dotfiles and provision your computer with prompts (which can be made headless with environment variables):
+## Quick Start
+
+To provision your workstation, you can run the following which will install some basic dependencies (e.g. Chezmoi) and provide interactive prompts where you can personalize your configuration:
 
 ```
 bash <(curl -sSL https://install.doctor/start)
 ```
 
-All the source files are located in ~/.local/share/chezmoi/home for the dotfiles and ~/.local/share/chezmoi/system for the system files. The roles / playbooks from [Gas Station](https://gitlab.com/megabyte-labs/gas-station) are occasionally used to fill in gaps. The software installation (which happens when you run Chezmoi or the link above) determines which package manager to use to install the software using [this software map](https://gitlab.com/megabyte-labs/misc/dotfiles/-/blob/master/.local/share/chezmoi/software.yml).
+If you fork this repository and would like to use your fork as the source, you can still use the command shown above by setting the `START_REPO` environment variable. If it is located on GitHub, you can do this by running:
 
-Many of the dotfiles (and system files) are templated. Those ones you will have to look at ~/.local/share/chezmoi to take a peek at. The static files are at the root of this repository for easy viewing.
+```
+START_REPO=my-gh-user/my-fork-name bash <(curl -sSL https://install.doctor/start)
+```
+
+Alternatively, if you want to host your project on GitLab or another git provider, then just specify the git remote's URL:
+
+```
+START_REPO=git@gitlab.com:megabyte-labs/sexy-start.git bash <(curl -sSL https://install.doctor/start)
+```
+
+### Quick Start Notes
+
+- The quick start script is tested on the latest versions of Archlinux, CentOS, Debian, Fedora, macOS, and Ubuntu
+- The quick start script is the preferred method of using this project to provision your system
+- The script can be configured to be completely headless by specifying environment variables which are detailed below
+- _Windows support is on the roadmap._
+
+<a href="#chezmoi-based" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+
+## Chezmoi-Based
+
+This project leverages [Chezmoi](https://github.com/twpayne/chezmoi) to provide:
+
+1. File diffs that show how files are being changed
+2. Easy-to-use encryption that lets you store private data publicly on GitHub
+3. A basic set of prompts that accept and integrate API credentials for services like CloudFlare, GitHub, GitLab, and Slack so that your development environment is augmented by free cloud services
+
+<a href="#security-focused" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+
+## Security Focused
+
+This software was built in an adversarial environment. This led towards a focus on security which is why we employ technologies like [Firejail](https://github.com/netblue30/firejail), [Portmaster](https://safing.io/), [Little Snitch](https://www.obdev.at/products/littlesnitch/index.html), and [Qubes](https://www.qubes-os.org/). Whenever possible, Flatpaks are used as the preferred application type. This also led to an emphasis on performance. When your workstation is possibly compromised or you have a good habit of reformatting your workstation on regular basis then it makes sense to use a provisioning system that can restore the workstation to a similar state quicker.
+
+<a href="#cross-platform" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+
+## Cross-Platform
+
+This project has been developed with support for Archlinux, CentOS, Fedora, macOS, Ubuntu, and Windows. Almost all the testing has been done on x86_64 systems but the system is flexible enough to be adapted for other systems such as ARM or FreeBSD. A lot of effort has also gone into supporting Qubes which, when fully provisioned, is basically a combination of all the operating systems we have developed this project for.
+
+### Custom Software Provisioning System
+
+The project also incorporates a custom [ZX](https://github.com/google/zx) script that allows you to choose which package managers you would like to manage your software. It attempts to be as asynchronous as possible without opening the door to errors. The script leverages the [software.yml](/software.yml) file in the root of this repository to figure out which package manager to use. By default, the installer will choose the most secure option (e.g. Flatpaks are preferred for Linux applications). The installer is more performant and less error-prone than our Ansible variant. It also makes it a lot easier to add software to your stack in such a way that you can keep the software regardless of what operating system you are using by storing everything in the aforementioned `software.yml` file.
+
+### Beautiful Anywhere
+
+Windows and macOS do a great job of making things look good from a UI perspective out of the box. Linux on the other hand requires some finessing especially when you follow our philosophy of taking many different operating systems and deploying similar software on them. A sizable amount of effort went into customizing the popular [Sweet](https://github.com/EliverLara/Sweet) theme and adapting it to our liking. Bells and whistles like a customized GRUB2 and Plymouth theme are included.
+
+### Qubes Support
+
+Qubes support is on its way.
+
+<a href="#gas-station" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+
+## Gas Station
+
+This project began as something to supplement our provisioning system that uses Ansible. The system is called [Gas Station](https://gitlab.com/megabyte-labs/gas-station). It includes hundreds of Ansible roles. If you look at the [`software.yml`](/sexy-start) file, you will notice that some of the Ansible roles that Gas Station provides are inside of it. By default, this project will try to install software / dependencies using other, lighter methods before resorting to using Ansible. This is because of the software installer order that is defined at the top of the software.yml file. Gas Station is also still used to house some of the variables / data that this project uses.
+
+<a href="#chezmoi" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
+
+## Chezmoi
+
+This project uses Chezmoi to orchestrate the provisioning. After calling the quick start script shown above, the quick start script will ensure some dependencies are installed (including Chezmoi) and then initiate Chezmoi. In order to customize this project, you should head over to the Chezmoi documentation to get a better understanding of why some of the files in this repository start with `dot_`, `run_`, etc.
+
+### Resetting Chezmoi
+
+This script is designed to run only the code that is necessary to improve performance. This is accomplished by using [`.chezmoiscripts`](home/.chezmoiscripts), Chezmoi's `onchange_` identifier, and a custom installer written in ZX that is powered by the software definitions in [`software.yml`](software.yml).
+
+If there is an error during the provision process or you make changes that are not being run during the provision process then you might want to clear Chezmoi's cache and configuration. This can be done on macOS/Linux by running:
+
+```
+rm -rf ~/.config/chezmoi && rm -rf ~/.cache/chezmoi
+```
 
 <a href="#contributing" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
 
 ## Contributing
 
-Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/megabyte-labs/hiawatha-dotfiles/issues). If you would like to contribute, please take a look at the [contributing guide](https://github.com/megabyte-labs/hiawatha-dotfiles/blob/master/docs/CONTRIBUTING.md).
+Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/megabyte-labs/sexy-start/issues). If you would like to contribute, please take a look at the [contributing guide](https://github.com/megabyte-labs/sexy-start/blob/master/docs/CONTRIBUTING.md).
 
 <details>
 <summary><b>Sponsorship</b></summary>
@@ -112,4 +199,4 @@ Below you will find a list of services we leverage that offer special incentives
 
 ## License
 
-Copyright © 2020-2021 [Megabyte LLC](https://megabyte.space). This project is [MIT](https://gitlab.com/megabyte-labs/hiawatha-dotfiles/-/blob/master/LICENSE) licensed.
+Copyright © 2020-2021 [Megabyte LLC](https://megabyte.space). This project is [MIT](https://gitlab.com/megabyte-labs/sexy-start/-/blob/master/LICENSE) licensed.

Taskfile.yml

@@ -593,7 +593,7 @@ tasks:
       - |
         task --list > /dev/null || (echo "ERROR: Invalid Taskfiles!" && exit 1)
         git add --all
-      - HUSKY=0 git commit -m '🔧 chore(tweak): quick minor update' --no-verify
+      - 'HUSKY=0 git commit -m "🔧 chore(tweak): quick minor update" --no-verify'
       - git push origin master
 
   devcontainer:

docs/CONTRIBUTING.md

@@ -36,7 +36,7 @@ First of all, thanks for visiting this page 😊 ❤️ ! We are _stoked_ that y
 
 ## Code of Conduct
 
-This project and everyone participating in it is governed by the [Code of Conduct](https://github.com/megabyte-labs/hiawatha-dotfiles/blob/master/docs/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [help@megabyte.space](mailto:help@megabyte.space).
+This project and everyone participating in it is governed by the [Code of Conduct](https://github.com/megabyte-labs/sexy-start/blob/master/docs/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [help@megabyte.space](mailto:help@megabyte.space).
 
 <a href="#overview" style="width:100%"><img style="width:100%" src="https://gitlab.com/megabyte-labs/assets/-/raw/master/png/aqua-divider.png" /></a>
 
@@ -53,7 +53,7 @@ After you run `npm i`, you can view the available pre-defined build tool command
 ```
 ❯ npm run info
 
-> @mblabs/hiawatha-dotfiles@1.0.4 info
+> @mblabs/sexy-start@1.0.4 info
 > npm-scripts-info
 
 build:
@@ -229,7 +229,7 @@ Running `npm link` with the `package.json` configuration listed above will insta
 
 ## Pull Requests
 
-All pull requests should be associated with issues. You can find the [issues board on GitLab](https://gitlab.com/megabyte-labs/docker/hiawatha-dotfiles/-/issues). The pull requests should be made to [the GitLab repository](https://gitlab.com/megabyte-labs/docker/hiawatha-dotfiles) instead of the [GitHub repository](ProfessorManhattan/npm-hiawatha-dotfiles). This is because we use GitLab as our primary repository and mirror the changes to GitHub for the community.
+All pull requests should be associated with issues. You can find the [issues board on GitLab](https://gitlab.com/megabyte-labs/docker/sexy-start/-/issues). The pull requests should be made to [the GitLab repository](https://gitlab.com/megabyte-labs/docker/sexy-start) instead of the [GitHub repository](ProfessorManhattan/npm-sexy-start). This is because we use GitLab as our primary repository and mirror the changes to GitHub for the community.
 
 ### How to Commit Code
 

package.json

@@ -1,18 +1,18 @@
 {
   "private": false,
-  "name": "@installdoc/sexy-start",
+  "name": "@mblabs/sexy-start",
   "version": "0.0.1",
-  "description": "A glorious combination of application settings, theme files, and a performant cross-platform, desktop-oriented software installer.",
+  "description": "A glorious combination of application / theme settings and a performant cross-platform, desktop-oriented software suite.",
   "license": "MIT",
   "author": "Brian Zalewski <brian@megabyte.space> (https://megabyte.space)",
   "homepage": "https://megabyte.space",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/megabyte-labs/hiawatha-dotfiles.git"
+    "url": "git+https://github.com/megabyte-labs/sexy-start.git"
   },
   "bugs": {
     "email": "help@megabyte.space",
-    "url": "https://gitlab.com/megabyte-labs/hiawatha-dotfiles/-/issues"
+    "url": "https://gitlab.com/megabyte-labs/sexy-start/-/issues"
   },
   "type": "commonjs",
   "main": "dist/main.js",

software.yml

@@ -3602,7 +3602,7 @@ softwarePackages:
     _bin: beekeeper-studio
     _when:cask: '! test -d "/Applications/Beekeeper Studio.app"'
     cask: beekeeper-studio
-    choco:  beekeeper-studio
+    choco: beekeeper-studio
     flatpak: io.beekeeperstudio.Studio
   kodi:
     _bin: kodi