!Pipeline

⭐️ Star us on GitHub — it helps!

iPWA

🔥 Isomorphic progressive web native cloud monorepo generator with a codebase with only code.

How this works

Usually, when a product grows, it becomes inevitable that there are 2 apps - for web and for native. You will then need a web frontend team, native frontend team, a design team, a backend team, a devops team and QA. This repository aims to abstract most of those things so that you can focus on only one thing - creating stuff.

iPWA's purpose is to spin up a new project with everything setup. All you need to do is set the configurations and the rest is magic.

Features

- React, Redux (Web)
- React-native, Expo (Native)
- Node JS, Express (Backend)
- Docker, Helm, Terraform (Infra)
- Heroku, Firebase (Deployment)
- Jest, Cypress, Puppeteer, Percy (Tests)

Demo

- Dockerised iPWA - https://ipwa-core.herokuapp.com
- Regular iPWA - https://ipwa-core.firebaseapp.com
- Native iPWA - https://expo.io/@sreeram/ipwa-core

How we use it

When code is merged to master, we perform the following:

- Sanity Check - Builing, linting, unit tests.
- Staging in Heroku - Build a docker image and deploy it in Heroku.
- Regression tests - Run unit tests, Cypress tests, Puppeteer tests and Percy tests and upload the reports.
- Release docker image - Build and publish docker image to Dockerhub or GCR.
- Release Firebase - Deploy the isomorphic progressive web app into Firebase.
- Expo publish - Deploy the native app as OTA update.

Install

Install ipwa globally

``shell
npm i -g @jsdrome/ipwa
`

Create a new ipwa app

`shell
ipwa my-app install
`
This will create a new project called my-app in the current directory and install npm dependencies.

Setup

$3

`shell
config_secrets__linkedin__clientId
config_secrets__linkedin__clientSecret
config_secrets__github__clientId
config_secrets__github__clientSecret
const config_secrets__sendInBlue__user
const config_secrets__sendInBlue__pass
config_secrets_ipwa_encryptKey
config_props__gtmId
`

$3

`
IMAGE_NAME
HEROKU_APP_NAME
HEROKU_API_KEY
CYPRESS_TOKEN
CYPRESS_PROJECT_ID
PERCY_TOKEN
DOCKER_USER
DOCKER_PASS
FIREBASE_APP_NAME
FIREBASE_TOKEN
EXPO_CLI_USERNAME
EXPO_CLI_PASSWORD
config_props__url
`

$3

Development

$3

`shell
npm run build:dev
npm run start:dev
`

$3

Set IMAGE_NAME env variable in .env

`shell
npm run build:docker
`

$3

`shell
npm run test
`

$3

`shell
npm run test:cypress
`

$3

`shell
npm run test:puppeteer
``