Fork this repo as a starting point for side projects, hackathons, etc. Decisions are documented in ADR.md.

• Hyperapp: 1 kB JavaScript micro-framework for building declarative web applications
• Tailwind CSS: utility-first CSS framework for rapidly building custom user interfaces

• Node.js: Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine
• Restify: A Node.js web service framework optimized for building semantically correct RESTful web services ready for production use at scale.

• Google Sheets: spreadsheet program included as part of a free, web-based software office suite offered by Google within its Google Drive service
• tabletop: takes a Google Spreadsheet and makes it easily accessible through JavaScript

• Docker: computer program that performs operating-system-level virtualization, also known as "containerization"
• nginx: web server which can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache
• Parcel: blazing fast, zero configuration web application bundler
• PostCSS: tool for transforming styles with JS plugins
• Prettier: opinionated code formatter
• huksy: git hooks made easy

• cypress: Fast, easy and reliable testing for anything that runs in a browser. Install Cypress in seconds and take the pain out of front-end testing.

1. Fork this repo, change the name, and pull it locally
2. Install packages: npm i
3. (optional) Create a new Google Sheet, add some data, make it public, and set the DOC_ID in data-access

1. Install extensions:

• Tailwind CSS IntelliSense
• Prettier Now

2. Update configuration:

• Set editor.formatOnSave to true in settings to automatically format files (with prettier) on save.

npm run local-dev

Navigate to http://localhost:3000

npm run build
npm run docker:build
npm run docker:run

Navigate to http://localhost:8080

Open cypress GUI: npx cypress open
Run end-to-end suite: npm run test:e2e

As a serverless container hosting service, Hyper allows you to run containers without having to manage VMs or clusters

+ Very easy to setup and deploy
+ Reasonable pricing
- No free tier
- Not as popular as Heroku or Digital Ocean

Create an account:

1. Sign up for an account
2. Add a credit card to file
3. Go through the 3 step setup process

Setup: npm run hyper:setup
Deploy: npm run deploy

starter-kit is open source software licensed as MIT