Front-End Development Without Node_modules Using Skypack and Snowpack

Once upon a time, we could simply put an HTML and a script file into an FTP server, quickly have a working website and call it a day.

Today, we have to jump through many hoops just to get the right things in the right places. Suppose Alice wants to spend her weekend making a simple to-do app or whatever little idea she enjoys. First, she has to install a big heap of 10k npm packages files. Then she spends a few hours searching how to get this week's js bundler working with the latest typescript with the latest trending UI framework. And a lot frustrating when things don't work or those articles have just outdated. Once she has actually started building the first feature for her little fun app, the weekend has mostly gone!

But things are changing...

A little backstory: CommonJS and ES Module

Working with NodeJS, we all get familiar with CommonJS, the standard (read: legacy) way for NodeJS to load dependency code. After installing a module, for example,

lodash

require('lodash')

const {snakeCase} = require('lodash');

['HelloWorld', 'left pad', 'ECMAScript'].forEach(text => {
  console.log(snakeCase(text));
});

// somewhere in lodash package
function snakeCase(input) {
  // where magic happens
}

exports.snakeCase = snakeCase;

ECMAScript 2015 (ES6) introduced ES Module - an official, standardized module system for JavaScript. It took a while to get here. Nowadays, all major browsers and NodeJS (since v13.2.0) ship support for ES Module by default. ES Module has the advantage of static analysis, tree shaking, and asynchronous.

import {snakeCase} from 'lodash';

['HelloWorld', 'left pad', 'ECMAScript'].forEach(text => {
  console.log(snakeCase(text));
});

// somewhere in lodash package
export function snakeCase(input) {
  // where magic happens
}

In NodeJS, to enable ES Module, we have two choices: use .mjs extension or set

"type": "module"

Many packages in NodeJS are already shipped with ES Module files. But many packages are not. At the time of this writing, in the top 10 depended packages on npm, only tslib supports ES Module file by including

"exports"

import

But browsers don't have that privilege. What if you want to import your favorite node module in the browser? Well, you have to be lucky. At the time of this writing, the recommended way for React to get started in the browser is to include the UMD version in

<script>

window.ReactDOM

<script src="https://unpkg.com/react@17/umd/react.development.js"></script>
<script src="https://unpkg.com/react-dom@17/umd/react-dom.development.js"></script>
<script>
  ReactDOM.render(
    <h1>Hello, world!</h1>,
    document.getElementById('root')
  );
</script>

No ES Module for Alice.

Skypack

Skypack is a wonderful CDN service that transpiles node packages to be able to work well in the browser. It's backed by the Snowpack team. Simply put the package name@version after cdn.skypack.dev and you are ready to go:

<script type="module" src="myscript.js"></script>

// myscript.js
import { snakeCase } from 'https://cdn.skypack.dev/lodash@4';

['HelloWorld', 'left pad', 'ECMAScript'].forEach(text => {
  console.log(snakeCase(text));
});

It just works! Of course, you may ask, there is "lodash-es" that we can import. But many packages don't have their doppelgängers. Or they are not frequently updated. Here, skypack.dev comes to the rescue.

It still has some problems, though. For unclear reasons, some versions did not work. When visiting cdn.skypack.dev/react@16, the React version 17 is served instead. But the future is bright. Alice can now start working right on her app without spending most of her weekend configuring this week's js bundler ...

Side note: I also put my own version at espkg.vercel.app/react@16. You can use espkg.vercel.app as an alternative until Skypack team fixes the problem. Other packages also work, for example, espkg.vercel.app/lodash@4 (give it a little time for building, then the response will be cached by Vercel).

Snowpack

Okay, I lied, a bit. TypeScript won't work directly in the browser. You still need some more work. Here comes the real power of Snowpack: minimal config and remote packages. You don't even have to install node_modules to start working with your little fun app. Simply run 2 setup commands:

yarn global add snowpack
snowpack init

This will give you an empty skeleton snowpack.config.js. Then add the single line config

source: 'remote'

packageOptions

// snowpack.config.js
packageOptions: {
    source: 'remote',
},

That's all. Now run

snowpack dev

<!doctype html>
<html lang="en">
<head>
  <title>My little app</title>
</head>
<body>
  <script type="module" src="myscript.js"></script>
</body>
</html>

// myscript.ts
import {snakeCase} from 'lodash';

const words: string[] = ['HelloWorld', 'left pad', 'ECMAScript'];
words.forEach(text => {
  console.log(snakeCase(text));
});

It just works! 🎉 Look ma, no node_modules! No package.json! We even got TypeScript and hot-reload for free. Yay!

Recap

The example code can be downloaded here: gist.github.com/olvrng. There are other configs on snowpack.config.js that you may need. Let's save that for another day. Now start tinkering with your app and spend your precious time on the most valuable feature! 🚀🚀

P.S.

Oh, but Alice wants to use less. No worry, just a single line config... I swear! She could add a file mystyle.less and one more line for snowpack.config.js. Everything will be okay. Well, this time she must remember to run

yarn add snowpack-plugin-less

// snowpack.config.js
plugins: [
  'snowpack-plugin-less',
],

// myscript.ts
import {snakeCase} from 'lodash';
import './style.less'; // the less file

const words: string[] = ['HelloWorld', 'left pad', 'ECMAScript'];
words.forEach(text => {
  console.log(snakeCase(text));
});

Thank you for reading! And don't forget my little page espkg.vercel.app.

Previously published at https://olvrng.github.io/w/esm/