ipwa

⭐️ Star us on GitHub — it helps!

iPWA

🚀 Spin up an isomorphic progressive web app or native app deployable in the cloud, publishable as npm package or docker container with a fully automated supercharged pipeline, all in under an hour!

Salient Features

1. Frontend in React
2. Backend in Node
3. Native in Expo
4. Isomorphic Web Apps
5. Progressive Web Apps
6. Unit testing using Jest
7. Code coverage reports using Codecov
8. Regression testing using Cypress, Puppeteer & Percy
9. Docker containers
10. Helm charts deployable in a Kubernetes Cluster
11. Fully automated pipeline using Github actions
12. Deployable in Dockerhub and Github Container Registry
13. Deployable in Google Container Registry using Terraform(WIP)
14. Deployable in npm and Github Package Register as npm package.
15. Integrated with Google Analytics
16. Integrated with Sentry

How this works

All you need to do is spin up a new project, sign up to a few providers, set the tokens and secrets correctly and the rest is all magic. When you push code to master, it will just be deployed everywhere in 10 minutes after a series of checks.

Setup Project

1. Install ipwa - npm i -g ipwa
2. Spawn a new ipwa app - ipwa my-app
3. Create new firebase project and set FIREBASE_APP_NAME and FIREBASE_TOKEN secrets
4. Create new heroku app and set HEROKU_APP_NAME and HEROKU_API_KEY secrets
5. Integrate project with Codecov and set CODECOV_TOKEN secret
6. Sign up to Docker and set DOCKER_USER and DOCKER_PASS secrets, also set GITHUB_DOCKER_IMAGE_NAME & DOCKERHUB_DOCKER_IMAGE_NAME in ./.github/workflows/build-master.yml.
7. Run npm run test:cypress:open, create a new project and set CYPRESS_PROJECT_ID and CYPRESS_TOKEN secrets
8. Set your stage url in .configrc
9. Integrate project with Percy and set PERCY_TOKEN env variable
10. Sign up to npm and set NPM_TOKEN
11. Create new Github project, make sure Github actions are enabled, initiate, add, commit, push.

Detailed Instructions

Setup Project

1. Install ipwa

npm i -g ipwa

1. Spawn a new ipwa app.

ipwa my-app

Run locally normally

Make sure npm dependencies are installed.

npm run dev in one shell,

npm run nodemon in another.

Run locally as a docker container

• Set the following environment variables locally.
  • DOCKER_IMAGE_NAME

npm run build-docker

Run locally as a helm app

Make sure minikube and helm are installed.

Set HELM_APP_NAME environment variable.

Run locally:

npm run build:helm
npm run build:helm:uninstall

Run unit tests locally

npm run test

Setup Github actions

Set up the secrets given in the sections below.

Setup Codecov

• Sign up in Codecov and integrate it with your project.
• Set the following environment secrets.
  • CODECOV_TOKEN

Run locally:

npm run test:codecov

Run in CI: See workflow file.

Setup Cypress

• Sign up in Cypress and integrate it with your project.
• Set the following environment secrets.
  • CYPRESS_PROJECT_ID
  • CYPRESS_TOKEN

Run locally:

npm run test:cypress:run

Run in CI: See workflow file.

Setup Percy

• Sign up in Percy and integrate it with your project.
• Set the following environment secrets.
  • PERCY_TOKEN

Run locally:

npm run test:percy

Run in CI: See workflow file.

Setup Puppeteer

Run locally:

npm run test:puppeteer

Run in CI: See workflow file.

Setup Heroku Deployment

• Sign up in Heroku and create a new app.

• Set the following environment secrets.

  • HEROKU_APP_NAME
  • HEROKU_API_KEY

Run locally:

npm run release:heroku

Run in CI: See workflow file.

Setup Firebase deployment

• Sign up in Firebase and integrate it with your project.
• Set the following environment variables locally.
  • FIREBASE_TOKEN

Run locally:

npm run release:firebase

Run in CI: See workflow file.

Setup Github Container Registry release

Run locally: -

Run in CI:

Set GITHUB_DOCKER_IMAGE_NAME in ./.github/workflows/build-master.yml.

Setup Dockerhub Container Registry release

Run locally: -

Run in CI:

Set DOCKERHUB_DOCKER_IMAGE_NAME in ./.github/workflows/build-master.yml.

Setup npm publishing

• Sign up in npm and integrate it with your project.
• Set the following environment secret.
  • NPM_TOKEN

Run locally: -

Run in CI: See workflow file.

Setup Expo (native app)

Run locally:

expo:start
expo:android
expo:ios
expo:web
expo:eject