ANDO

A shell script for a clean and simple front-end web development environment on macOS.

Tadao Ando is a a Japanese self-taught architect whose style emphasizing nothingness and empty space to represent the beauty of simplicity.

This script was inspired by his philosophy.

Ando is meant to run multiple times on the same machine. It installs, upgrades, or skips depending on what is already installed.

Install

Download:

git clone https://github.com/buildingsareheavy/ando.git && cd ando

Review: (please don't run scripts you don't understand):

less blueprints

Run:

sh goAndo

Or Run with log:

sh goAndo 2>&1 | tee ~/ando.log

Your last sh goAndo run will be saved to ~/ando.log. To review it, run less ~/ando.log.

Check and debug the log:

less ~/ando.log

Warning: I advise against running this script unless you understand what it’s doing to your computer.

It is highly recommended to run the script regularly to keep your computer up to date.

What it sets up

The setup process will install:

Basic Tools

• XCode Command Line Tools for developer essentials.
• Bash-it, for a more powerful bash.
• NVM for managing and installing multiple versions of Node.js and npm
• Homebrew for managing operating system libraries.

Homebrew: Brews

• Git for version control.
• Tig is a text interface for Git repositories.
• Mas is a Mac App Store command line interface.
• wget is an internet file retriever.
• Hub adds GitHub support to git on the command-line.
• ImageOptim-CLI to make batch optimisation of images part of your automated build process.
• Rbenv for managing versions of Ruby.
• Yarn for managing JavaScript packages.
• ZSH is a UNIX shell (command interpreter).
• ZSH Syntax Highlighting Fish shell like syntax highlighting for zsh.
• TheFuck helps programatically correct mistyped console commands.
• WP-CLI is the command-line interface for WordPress. You can update plugins, configure multisite installations and much more, without using a web browser.

Homebrew: Casks

• Affinity Photo Beta is a raster graphics editor.
• Affinity Designer Beta is a vector graphics editor.
• Firefox for web browsing and testing.
• Firefox Developer Edition is my main web browser for development. Best CSS tools built in. Read more here.
• Google Chrome for fast and free web browsing.
• Hyper for an alternative terminal.
• ImageOptim to make batch optimisation of images part of your automated build process.
• MAMP for PHP / Wordpress development.
• Microsoft Edge Dev for testing.
• Spotify for music.
• Visual Studio Code IDE.
• FONT: Dejavu Sans Mono for command-line font. Has glyph support for git and works well with PowerLevel10K (a ZSH theme).
• FONT: Victor Mono for text editor font. Supports ligatures and has a nice cursive italic font, similar to Dank Mono or Fira Code.

App Store Apps

• Amphetamine is a powerful keep-awake utility.
• Be Focused - Focus Timer is a pomodoro style focus timer for work and study.
• Viper FTP Lite is a User-friendly and reliable Mac FTP/FTPS/SFTP/WebDav/AS3 client.

NPM Packages

• 11ty is a simpler static site generator.
• ESLint linting utility for JavaScript.
• Gatsby a static site generator built with React.
• Gridsome a static site generator built with Vue.
• Gulp a task/build runner for development.
• ImageOptim-CLI to make batch optimisation of images part of your automated build process.
• Netlify lets you deploy sites or configure continuous deployment straight from the command line.
• MAMP-CLI a command line interface for working with MAMP. It can start and stop your MAMP, but also easily switch the document root so that you can switch projects easily by using a favorite list.
• Pa11y a command-line interface which loads web pages and highlights any accessibility issues it finds. Useful for when you want to run a one-off test against a web page.
• VSCE - The Visual Studio Code Extension Manager.
• Vue-CLI for quickly scaffolding Single Page Applications.
• yo CLI tool for running Yeoman generators.

ZSH Settings (Prompted): For Initial Setup Only

• Oh My ZSH a framework for managing your zsh configuration.
• Powerlevel10K a ZSH theme.

Dotfiles (Prompted)

• .zshrc for customizing your Oh-My-ZSH! settings.
• .hyper.js for customizing your Hyper terminal. This is where the fonts color themes are held. Current theme is New Moon.
• .p10k.zsh for customizing your Powerlevel10K ZSH theme. This is where the terminal theme is held. Like the arrows and git icons.

_{See materials for the full list of apps that will be installed. Adjust it to your personal taste.}

It should take less than 20 minutes to install (depends on your machine).

Post-Install

Open VS Code and install the Settings Sync extension.

In the extension settings under Configuration click the Login With Github button and follow instructions to connect.

If Needed: Go to https://gist.github.com/ and look for a gist called "Cloud Settings". Copy the ID in the URL to paste into "Gist ID".

This should sync all of your VSCode settings, extensions and preferences.

Open command palette and run Sync: Download Settings.

Known Issues

If you are doing a completely fresh install and have not installed Xcode already, it will prompt you to do so and possibly say that Ando has failed. Install Xcode and run the script again.

Cask does not recognize applications installed outside of Homebrew Cask – in the case that the script fails, you can either remove the application from the install list or uninstall the application causing the failure and try again.

Acknowledgements

Code was inspired, copied and modified from: Mina Markham's formation

📜 License

Ando is free software, and may be redistributed under the terms specified in the LICENSE file.