# title: Homebrew
# homepage: https://brew.sh
-# tagline: The Missing Package Manager for macOS (or Linux)
+# tagline: |
+# Brew: The Missing Package Manager for macOS (and Linux).
# description: |
# Homebrew installs the stuff you need that Apple (or your Linux system) didn’t.
# examples: |
# title: Caddy
# homepage: https://github.com/caddyserver/caddy
-# tagline: Fast, multi-platform web server with automatic HTTPS
+# tagline: |
+# Caddy is a fast, multi-platform web server with automatic HTTPS.
# description: |
-# Caddy is an extensible server platform that uses TLS by default.
+# Caddy makes it easy to use Let's Encrypt to handle HTTPS (TLS/SSL) and to reverse proxy APIs and WebSockets to other apps - such as those written node, Go, python, ruby, and PHP.
# examples: |
# ```bash
# caddy start
# title: Flutter
# homepage: https://flutter.dev
-# tagline: UI Toolkit for mobile, web, and desktop
+# tagline: |
+# Flutter is a UI Toolkit for mobile, web, and desktop.
# description: |
# Flutter is Google’s UI toolkit for building beautiful, natively compiled applications for mobile, web, and desktop from a single codebase.
# examples: |
# title: Gitea
# homepage: https://github.com/go-gitea/gitea
-# tagline: Git with a cup of tea, painless self-hosted git service
+# tagline: |
+# Gitea: Git with a cup of tea, painless self-hosted git service.
# description: |
-# `gitea` is a clean, lightweight self-hosted Github alternative, forked from Gogs. Lighter and more user-friendly than Gitlab.
+# Gitea is a clean, lightweight self-hosted Github clone. It only uses a few megabytes of RAM so it's perfect for hosting git on small VPSes and Raspberry Pis. It's forked from Gogs, and very familiar user-friendly for Github users in comparison to Gitlab or Bitbucket.
# examples: |
# ```bash
-# gitea --version
+# gitea web --config $HOME/srv/git.example.com/custom/conf/app.ini
# ```
END
# title: Go
# homepage: https://golang.org
-# tagline: The Go Programming Language tools
+# tagline: |
+# Go makes it easy to build simple, reliable, and efficient software.
# description: |
-# Go is an open source programming language that makes it easy to build simple, reliable, and efficient software.
+# Go is designed, through and through, to make Software Engineering easy. It's fast, efficient, reliably, and something you can learn in a weekend. If you subscribe to [_The Zen of Python_](https://www.python.org/dev/peps/pep-0020/), you'll [love](https://go-proverbs.github.io/) [Go](https://www.youtube.com/watch?v=PAAkCSZUG1c).
# examples: |
# ```bash
# mkdir -p hello/
# title: Hugo
# homepage: https://github.com/gohugoio/hugo
-# tagline: The world’s fastest framework for building websites
+# tagline: |
+# Hugo: The world’s fastest framework for building websites.
# description: |
-# Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.
+# Hugo is one of the most popular open-source static site generators. It makes building websites fun again.
# examples: |
# ```bash
+# # create a new site
+# hugo new site ./blog.example.com
+# ```
+#
+# ```bash
+# # compile a site
# hugo
# ```
#
# ```bash
+# # serve a site in dev mode
# hugo server -D
# ```
# title: macOS
# homepage: https://bootableinstaller.com/macos/
-# tagline: Bootable macOS Installer
+# tagline: |
+# Creates a bootable macOS installer ISO in ~/Downloads.
# description: |
# Downloads the official OS X / macOS dmg from Apple to create bootable installers - works from macOS, Linux, or even Windows (through VirtualBox).
# examples: |
#
# title: Node.js
# homepage: https://nodejs.org
-# tagline: JavaScript V8 runtime
+# tagline: |
+# Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.
# description: |
-# Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine
+# Node is great for simple, snappy HTTP(S) servers, and for stitching APIs together with minimal fuss or muss.
# examples: |
#
# ### Hello World
# title: Pathman
# homepage: https://git.rootprojects.org/root/pathman
-# tagline: cross-platform PATH management for bash, zsh, fish, cmd.exe, and PowerShell
+# tagline: |
+# Pathman: cross-platform PATH management for bash, zsh, fish, cmd.exe, and PowerShell.
# description: |
# Manages PATH on various OSes and shells
# - Mac, Windows, Linux
# title: Postgres
# homepage: https://www.postgresql.org/
-# tagline: PostgreSQL: The World's Most Advanced Open Source Relational Database
+# tagline: |
+# PostgreSQL: The World's Most Advanced Open Source Relational Database.
# description: |
# Postgres is the all-in-one database for beginners and experts alike. It handles SQL, 'NoSQL', JSON, HSTORE, Full-Text Search, Messages Queues and more. Best bang for buck.
# examples: |
# title: Prettier
# homepage: https://prettier.io/
-# tagline: Prettier is an opinionated code formatter.
+# tagline: |
+# Prettier is an opinionated code formatter.
# description: |
# The core value of Prettier is not in what it gives, but in what it takes away: countless hours of bikeshedding over code style choices. Also, it makes git merges much nicer.
# examples: |
# title: Ripgrep
# homepage: https://github.com/BurntSushi/ripgrep
-# tagline: a modern drop-in grep replacement
-# alias: rg
+# tagline: |
+# Ripgrep is a git and sourcecode-aware drop-in grep replacement.
# description: |
-# `rg` is a drop-in replacement for `grep`, that respects `.gitignore` and `.ignore`, has all of the sensible default options you want (colors, numbers, etc) turned on by default, is written in Rust, and simply outperforms grep in every imaginable way. R.I.P. grep.
+# Ripgrep (`rg`) is smart. It's like grep if grep were built for code. It respects `.gitignore` and `.ignore`, has all of the sensible options you want (colors, numbers, etc) turned on by default, is written in Rust, and simply outperforms grep in every imaginable way. R.I.P. grep.
# examples: |
#
# ```bash
-# rg <search-term> # searches recursively, ignoing .git, node_modules, etc
+# rg <search-term> # searches recursively, ignoring .git, node_modules, etc
# ```
#
# ```bash
# title: Rust
# homepage: https://rust-lang.org
-# tagline: The Rust Toolchain
+# tagline: |
+# Rust: Empowering everyone to build reliable and efficient software.
# description: |
-# A language empowering everyone to build reliable and efficient software.
-#
-# Rust is the modern language used to build all of your favorite CLI tools, such as
+# Rust is what C++ and D were trying to do, but didn't. It's a modern, safe, high-performance language, which also just so happens to be used to build all of your favorite CLI tools, such as:
# - rg (ripgrep, modern grep)
# - fd (modern find)
# - sd (modern sed)
# title: Serviceman
# homepage: https://git.rootprojects.org/root/serviceman
-# tagline: cross-platform service management for Linux, Mac, and Windows
+# tagline: |
+# Serviceman: cross-platform service management for Linux, Mac, and Windows.
# description: |
-# A system laucher that wraps `launchctl` (macOS), `systemctl` (Linux),
-# and the Windows Registry to work cross-platform.
+# Serviceman is a hassle-free wrapper around your system launcher. It works with `launchctl` (macOS), `systemctl` (Linux), and the Windows Registry to make it easy to start _user_ and _system_ level services, such as webservers, backup scripts, network and system tools, etc.
# examples: |
#
# Works with anything, including
# title: vim-sensible
# homepage: https://github.com/tpope/vim-sensible
-# tagline: sensible defaults for vim
+# tagline: |
+# Vim Sensible: sensible defaults for vim
# description: |
# Think of sensible.vim as one step above 'nocompatible' mode: a universal set of defaults that (hopefully) everyone can agree on.
# examples: |
-# N/A
+#
+# Installs to `$HOME/.vim/pack/plugins/start`.
+# It just works.
+#
mkdir -p $HOME/.vim/pack/plugins/start
rm -rf $HOME/.vim/pack/plugins/start/sensible
# title: Webi
# homepage: https://webinstall.dev
-# tagline: webinstall.dev for the CLI
+# tagline: |
+# Webi is how developers install their tools.
# description: |
-# for the people like us that are too lazy even to run <kbd>curl https://webinstall.dev/PACKAGE_NAME | bash</kbd>
+# Webi is what you would have created if you automated how you install your common tools yourself: Simple, direct downloads from official sources, unpacked into `$HOME/.local`, added to `PATH`, symlinked for easy version switching, with minimal niceties like resuming downloads and 'stable' tags.
+#
+# - Easy to remember.
+# - No magic, no nonesense, no bulk.
+# - What you would have done for yourself.
+#
# examples: |
+# You can install _exactly_ what you need, from memory, via URL:
+#
+# ```bash
+# curl https://webinstall.dev/node@lts | bash
+# ```
+#
+# Or via `webi`, the tiny `curl | bash` shortcut command that comes with each install:
+#
# ```bash
# webi node@latest
# ```
-# <br/>
#
# ```bash
# webi golang@v1.14
# ```
-# <br/>
#
# ```bash
# webi rustlang
# ```
+#
+# You can see exactly what PATHs have been edited:
+#
+# ```bash
+# pathman list
+# ```
+#
+# And where:
+#
+# ```bash
+# cat $HOME/.config/envman/PATH.env
+# ```
+#
{
projects / webi-installers / .git / commitdiff