Colocating tests is putting your test next to its file.

Why colocate tests? Because colocating provides:

• Better visibility
• Simpler mental models
• Less context switching

Layout

Example of a directory structure containing colocated tests:

.
└── src
    ├── file.js
    └── file.test.js

Example of a directory structure containing non-colocated tests:

.
├── src
│   └── file.js
└── test
    └── file.test.js

Import

Colocated tests simplifies import paths:

// src/file.test.js
const file = require('./file');

Compared to non-colocation:

// test/file.test.js
const file = require('../test/file');

For small projects, non-colocation is manageable. But for larger projects, the import paths can get unwieldly:

const file = require('../../../test/dir/subdir/file');

Refactor

For colocated tests…

YouTube:

CodeSandbox:

Motivation

Why use Context to handle React state? The same reason you use Redux to manage your application store. If your components talk to one another and lifting state becomes cumbersome, then Context is a native way to deal with your application state.

Prerequisites

We will be refactoring <App>—which uses local state—to use Context:

As you can see, there’s a counter with 2 buttons that increments or decrements the count.

Provider

Create <Provider> and set prop value to 0:

Render <Provider> as the top-level component in index.js:

Get the Provider value with useContext in <App>:

useReducer

…

YouTube:

CodeSandbox:

Class

Rendering initial state:

Updating state:

Class state property must be an object since setState takes an object of state variables to update.

Function

Rendering initial state:

Updating state:

Background

What are Gherkin feature files? They’re human-readable documentation that can map to automated tests.

Gherkin is a DSL (domain-specific language) for BDD (behavior-driven development).

Example

Here’s an example of using Gherkin to describe how to search for remarkablemark on Google:

Given I am on "https://www.google.com/"
When I click on the search bar
    And I type "remarkablemark"
    And I press "Enter"
Then I see in the search results "remarkablemark.org"

Each line is a step:

• Given sets up the scenario.
• When describes the action.
• Then states the expected outcome.
• And chains successive Given’s, When’s, and Then’s.

Steps can be organized under Scenario’s, and…

This article goes over how to remove Travis CI from your GitHub’s:

• Personal account
• Organization account
• Repository

Personal

Revoke Travis CI from Account settings > Applications:

In Applications, check if Travis CI is added in:

• Installed GitHub Apps
• Authorized GitHub Apps

Organization

Deny Travis CI access from Organization > Account settings > Third-party access:

This article describes the difference between planning, grooming, and estimation in agile methodology.

Planning

Based on the company goals and user research, the Product Manager (PM) comes up with the business case.

The Designer comes up with prototypes and conducts user testing. This happens during design sprints, which engineers can participate in the discussion and activity.

Once the business case is approved, the PM creates an initiative with an epic for spikes and tech designs. (See guide for writing technical specs.)

The Tech Lead (lead engineer) works on the tech design, which is reviewed by the team.

Once the tech design…

This article goes over how to deploy to Heroku using the GitHub Actions workflow.

Prerequisites

Heroku

Create a Heroku app and save the app’s name and email associated with your account. Then go to Account settings and copy your API Key.

GitHub

Go to your GitHub repository’s Settings > Secrets and set the secrets:

• HEROKU_API_KEY
• HEROKU_APP_NAME
• HEROKU_EMAIL

GitHub Action

Workflow to deploy using Deploy to Heroku action:

The action pushes to the main branch.

Check out the additional options.

Custom Workflow

Workflow to deploy using a custom job:

The differences between the 2 workflows are explained below.

Checkout

The Checkout action must fetch the entire Git…

Set an output parameter for .nvmrc:

Evaluate the expression in setup-node:

Here’s the full example of setting up Node.js with the .nvmrc version in a GitHub Actions workflow:

The original solution is from @damccorm’s comment. The updated solution is from @peaceiris’s comment. Credit goes to them.

This article was originally published on remarkablemark.org on March 11, 2021.