Skip to main content

Using the Node filesystem API (fs) to Automate File Creation (Video)

04-22-19 Adam Simpson

Are you looking to avoid more JavaScript dependencies but need to scaffold files as part of your build tooling? The Node filesystem API and Adam might have your answer.

YouTube embeds track user data for advertising purposes. You can watch the video on YouTube if you prefer not to grant consent for YouTube embeds.

Using the Node filesystem API (fs) to Automate File Creation.

Recently on a client project, we were creating and using a design system, and we ran into a problem tailor-made for a build tool to solve: pattern generation. The way this particular design system worked was that each “pattern” lived in its own directory, which contained four files:

  • a scss file

  • a twig template file

  • a json data file

  • a js file

Typically, we’ve reached for something like Yeoman to handle these types of scaffolding problems; however, I’ve recently become exhausted with the amount of JavaScript dependencies I typically use. Therefore, I decided to see what we could accomplish with the Node standard library, and I was pleasantly surprised by what fs.writeFile had to offer.


Node’s FS module provides a host of filesystem related functionality. We can use two specific methods to solve our problem without pulling down a bunch of third-party code:

  1. mkdirSync

  2. writeFileSync

mkdirSync creates directories given a path plus other options. At its most basic, it looks like this:


writeFileSync creates files at a specific path and optionally fills them with data. At its most basic, it looks like this:


Basic flow

A stripped down example of our scaffold script is only 23 lines!

const fs = require('fs');

const args = process.argv.slice(2);

function makeDirs() {
  // Here we want to make sure our directories exist.
  fs.mkdirSync('./scss', { recursive: true });
  fs.mkdirSync('./js', { recursive: true });

function generate(fileName) {
    `// This is a comment to begin our SCSS file.\n`
    `// Please follow JSDoc standards for commenting.\n`


We can then invoke this script from the command line like this:

node index.js slider

This command will generate our files and name them “slider.”

What’s great about this approach is the complete lack of third-party code. This is all “vanilla” Node. The basic logic of the script is:

  1. Make sure the directories that will contain the created files actually exist.

  2. Write the files with the necessary information inside them.

Another note is that ES6 string templates make this code even easier to follow by allowing us to easily interpolate variables into our path names.

Forward Thinking

Node has a solid standard library that can solve a wide range of problems. Relying on Node to solve problems in the frontend stack—instead of insert “flavor of the month build-tool”—protects that project from outdated dependencies in the future and provides a common set of APIs for current and future developers.

Sparkbox’s Development Capabilities Assessment

Struggle to deliver quality software sustainably for the business? Give your development organization research-backed direction on improving practices. Simply answer a few questions to generate a customized, confidential report addressing your challenges.

Related Content

User-Centered Thinking: 7 Things to Consider and a Free Guide

Want the benefits of UX but not sure where to start? Grab our guide to evaluate your needs, earn buy-in, and get hiring tips.

More Details

See Everything In

Want to talk about how we can work together?

Katie can help

A portrait of Vice President of Business Development, Katie Jennings.

Katie Jennings

Vice President of Business Development