What I use in my craft
Tags: productivity, vscode, javascript
Published: 2019-06-13 11:38:50

This article aims to be a list of many of the tools I use for various areas of my software development workflow, in the hope that they help others. I'll try and keep it updated when I find new stuff worth sharing.

# Hardware

I’m a bit of a stationary and HID geek. I’ve used a variety of pens, notebooks and keyboards over the years, and have currently settled on these for my everyday needs.

*   [**Uni-ball PIN 0.3mm, 0.5mm and 0.8mm fine liners**](https://amzn.to/2Ibz3rM). These use pigment ink, which means they are long-lasting ‘archival’ inks (they don’t fade), and are also resistant to bleeding when using water-based pens to colour over top. The variety of line widths allows for creating a more detailed sketchnote or diagram without having to go over lines multiple times to make them stand out.
*   [**Tombow dual brush pens**](https://amzn.to/2Kr38FN) **(pastel colours)**. These are great, coupled with pigment fine liners to highlight parts of a diagram or sketchnote.
*   [**Rhodia A5 Wirebound Dot Notepad**](https://amzn.to/2uUK4F8). I came across Rhodia notepads after listening to [The Pen Addict](https://www.relay.fm/penaddict) podcast. The paper is smooth, works well with fountain pens, fine liners and felt tip pens, and the added dot-grid allows for writing straight as if on lined paper, as well as allowing diagrams to be drawn with straight lines as if on squared paper. The wire binding gives an easy tearaway option for disposing of temporary sketches, so it works well with my visual way of discussing architectures.
*   [**ErgoDox EZ keyboard**](https://ergodox-ez.com). Any mechanical keyboard which is compatible with the [QMK firmware](https://qmk.fm/) will give you the opportunity to add layers, macros, and shortcut keys to your keyboard, which can make you more productive and remove the need to constantly switch from keyboard to mouse. I’ve used a Microsoft Ergonomic Keyboard for decades, so didn’t want a non-split keyboard, and when I saw the ErgoDox, I was hooked. I can’t say the quirkiness didn’t add to the the appeal of it, but the comfort it gives is great. I now own two (one DIY, one prebuilt).

# Software

Most of my development is done on a MacBook Pro (2015 edition), so I’ll focus OS X. Many of the tools I use, however, are cross-platform, so will work on Linux, and possibly Windows.

*   [**iTerm 2**](https://www.iterm2.com/). A powerful replacement for the OS X Terminal which supports split-panes and tabs.
*   **ZSH with** [**Oh My ZSH**](https://ohmyz.sh/). If you use the terminal a lot, Oh My ZSH will likely improve your productivity. You can customise the appearance of the prompt, as well as enable plugins which auto-complete options within apps such as Git, Docker, Helm, and Node. I use the theme `kafeitu`.
*   [**Visual Studio Code**](https://code.visualstudio.com/). Over the years I’ve gone from using TextMate, to Sublime Text, to Atom, and now VSCode. It’s a fork of Atom, but although I install a ridiculous number of extensions on both Atom and VSCode, Atom slowed down significantly for me, so I lean towards VSCode now. The added abilities of VSCode for debugging JavaScript code make it great for my work. I’ll cover list some of the extension below.
*   [**Vim**](https://www.vim.org/), a terminal-based editor. I don’t do the majority of my coding in it anymore, but I do still use it for a significant part of my workflow, for quick scripts, remove administration, debugging, etc.
*   [**Divvy**](https://mizage.com/divvy/). A screen divider. There is an Open Source alternative called [Spectacle](https://www.spectacleapp.com/), but it doesn’t have quite the same UX for setting up new shortcuts.

## Visual Studio Code extensions

Along with the built-in capabilities of VSCode, I’ve found a bunch of extensions help me be more productive.

*   [**Docker**](https://marketplace.visualstudio.com/itemdetails?itemName=PeterJausovec.vscode-docker) provides intelligence for Dockerfiles as well as some useful shortcuts accessible from the command Palette.
*   [**EditorConfig**](https://marketplace.visualstudio.com/itemdetails?itemName=EditorConfig.EditorConfig), along with the accompanying `.editorconfig` file within a repository/directory, will ensure that basic formatting is kept consistent. (My current base file can be found [here](https://gist.github.com/dsample/8518280e8f2e28af09e4df8908122b40#file-editorconfig), along with some other useful files for setting up a repo for consistency).
*   [**ESLint**](https://marketplace.visualstudio.com/itemdetails?itemName=dbaeumer.vscode-eslint) will highlight code lint issues, and if you set the `"eslint.autoFixOnSave": true` setting, it will correct the trivial issues whenever you save the file, without the need for Prettier.
*   [**Expand Region**](https://marketplace.visualstudio.com/itemdetails?itemName=letrieu.expand-region), If you’re used to control+W in Visual Studio for selecting the current word, line, function, etc. with increasing scope each time you press it, this adds the same functionality to VSCode.
*   [**File Icons**](https://marketplace.visualstudio.com/itemdetails?itemName=file-icons.file-icons) has some nice icons for lots of file extensions.
*   [**GitHub Pull Requests**](https://marketplace.visualstudio.com/itemdetails?itemName=GitHub.vscode-pull-request-github) provides a way to view GitHub Pull Requests within VSCode, which is handy for Inner Sourcing/Open Sourcing.
*   [**GitLens**](https://marketplace.visualstudio.com/itemdetails?itemName=eamodio.gitlens) gives even more access to Git metadata and shortcuts.
*   [**Indent Rainbow**](https://marketplace.visualstudio.com/itemdetails?itemName=oderwat.indent-rainbow) shows a pleasant colour for each level of indent
*   [**Markdown All in One**](https://marketplace.visualstudio.com/itemdetails?itemName=yzhang.markdown-all-in-one) provides a wealth of tools for editing Markdown files
*   [**Markdownlint**](https://marketplace.visualstudio.com/itemdetails?itemName=DavidAnson.vscode-markdownlint) highlights issues you have with your Markdown files
*   [**Path Intellisense**](https://marketplace.visualstudio.com/itemdetails?itemName=christian-kohler.path-intellisense) helps auto-complete relational paths to files
*   [**Rainbow CSV**](https://marketplace.visualstudio.com/itemdetails?itemName=mechatroner.rainbow-csv) colour-codes columns of CSV files to help visual scanning of CSV data.
*   [**YAML**](https://marketplace.visualstudio.com/itemdetails?itemName=redhat.vscode-yaml) provides helpful support for YAML file editing, including linting.

### JavaScript-specific extensions

*   [**CodeMetrics**](https://marketplace.visualstudio.com/itemdetails?itemName=kisstkondoros.vscode-codemetrics) helps by letting you know when your functions are getting a bit long-winded and are in need of refactoring.
*   [**Glean**](https://marketplace.visualstudio.com/itemdetails?itemName=wix.glean) helps with refactoring React code
*   [**JS Refactor**](https://marketplace.visualstudio.com/itemdetails?itemName=cmstead.jsrefactor) helps with refactoring JavaScript code
*   [**NPM**](https://marketplace.visualstudio.com/itemdetails?itemName=eg2.vscode-npm-script) highlights issues with packages you depend on
*   [**NPM Intellisense**](https://marketplace.visualstudio.com/itemdetails?itemName=christian-kohler.npm-intellisense) helps import libraries by auto-completing package names
*   [**Version Lens**](https://marketplace.visualstudio.com/itemdetails?itemName=pflannery.vscode-versionlens) shows the version of your package dependencies and helps update your references to newer versions
*   [**Web Accessibility**](https://marketplace.visualstudio.com/itemdetails?itemName=MaxvanderSchee.web-accessibility) highlights where you might have accessibility issues in your HTML/React markup