This template repo lets you quickly get a jamstack frontend up and running using a set of technologies chosen for simplicity and fast feedback.
How fast is fast? UX research says 400 milliseconds is about as long as you can wait without feeling like you're waiting. Flow (the typechecker) and Taste (the test framework) can check your code for mistakes in under 400ms.
These instructions assume you have yarn and node installed.
- Click the "Use this template" button on GitHub to create a new project based on this template repo.
- Clone the repo.
- Change the package name, author, and license in
package.json, and the<title>and favicon inindex.html.
| command | effect |
|---|---|
| yarn dev | serves the app on port 8080 and opens it in your default browser |
| yarn build | builds the app into the docs dir (the strange choice of directory name ensures you can deploy on GitHub Pages) |
| yarn flow | typechecks your code |
Tests run automatically in the browser on each page load, and the page reloads whenever you change a source file.
See @benchristel/taste for more info about the test framework.
If you run into problems, or you find simple ways to improve the development experience, please let me know by opening an issue on this repo.
The dev server crashes sometimes (when you rename a JS file? TODO: figure out exactly what the trigger is).