https://github.com/poviolabs/spa-deploy-cli
https://github.com/poviolabs/spa-deploy-cli
cli react tool
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/poviolabs/spa-deploy-cli
- Owner: poviolabs
- Created: 2024-05-19T10:37:49.000Z (about 2 years ago)
- Default Branch: v4
- Last Pushed: 2024-11-01T09:52:16.000Z (over 1 year ago)
- Last Synced: 2025-06-19T06:43:49.603Z (about 1 year ago)
- Language: TypeScript
- Size: 233 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SPA Deploy CLI
Use this tool to deploy and configure an SPA.
Features:
Static SPA deploy:
- Deploy to AWS S3
- Targeted CloudFront invalidation and caching
- Embed environment variables into HTML
Next.js Configuration:
- From SSM Parameter Store
Examples:
- [Vue Basic](./examples/vue-basic)
# Setup
Running without installing. Make sure to lock the version, check the latest version on npm.
```
yarn dlx @povio/spa-deploy-cli@4.2
```
If using yarn cache, you can install the package:
```bash
yarn add @povio/spa-deploy-cli
```
# Configure
```yaml
accountId: "000000000000"
region: us-east-1
# Static SPA deploy config
deploy:
buildPath: "./dist"
# only include local files matching this glob
#includeGlob:
# - glob: "**.css"
# cacheControl: "max-age=2628000, public"
# exclude local and remote files matching this glob
#ignoreGlob: "**.css"
s3:
bucket: myapp-dev-website
# prefix to upload to, default is root
#prefix:
# delete all ignored/unknown files
# use `--dry-run` to see what would be deleted
#purge: false
# re-upload even if the file is the same (also updates cacheControl)
#force: false
# changes should not invalidate cloudfront cache
#skipChangesInvalidation: false
# default cache control
#cacheControl: "max-age=2628000, public"
# pattern match cache control, first match wins, default is cacheControl
#cacheControlGlob:
# - glob: "*.html"
# cacheControl: "no-cache, no-store, must-revalidate"
# @deprecated - set matching files to "public, must-revalidate"
#invalidateGlob: "*.html"
# set ACL, not needed if using bucket policy
#acl: "public-read"
cloudfront:
distributionId: CF000000000000
invalidatePaths: "/*"
# Environment file config
configs:
# Write into env file (Next.js)
# destination: ./.env.local
# Write into yaml
# destination: ./production.yaml
# Write into .html, in the head section or
# Warning: all values will be public
# destination: ./dist/index.html
values:
# load config from ./.config/${stage}.base.template.env
# and interpolate ${arn:aws:ssm..} and ${env:ENV_VALUE} values
# load them onto the root
- name: "@"
configFrom: base.template
# simple value mapping
- name: database__password
valueFrom: arn:aws:ssm:::parameter/myapp-dev/database/password
# JSON object mapping
- name: database
valueFrom: arn:aws:ssm:::parameter/myapp-dev/database
- name: database__host
valueFrom: env:DATABASE_HOST
```
### Example
Where `configFrom: base.template` and the config file is `.config/${stage}.base.template.yml`:
```yaml
APP_RELEASE: ${func:release}
APP_STAGE: ${func:stage}
APP_VERSION: ${env:APP_VERSION}
STATIC_URL: https://static.example.com
NEXT_PUBLIC_SENTRY_CDN: https://public@sentry.example.com/1
```
the output will be at the set destination, for example `.env.local`:
```
APP_RELEASE=61be6e2c61be6e2c61be6e2c61be6e2c
APP_STAGE=myapp-stg
APP_VERSION=0.0.1
STATIC_URL: https://static.example.com
NEXT_PUBLIC_SENTRY_DSN=https://public@sentry.example.com/1
```
## Injecting the environment
```bash
yarn spa-deploy bootstrap --stage myapp-stg
```
### Pure SPA or after build time configuration
Using the `destination: ./dist/index.html` option, you can inject the environment into the HTML file.
The file will be edited in place, with the following content inserted into
the `` section, replacing any existing ``:
```html
<script id="env-data">
// you can add local testing variables here,
// this will get overwritten at build
window.APP_STAGE = "myapp-stg";
```
## Static SPA Deploy
```bash
yarn spa-deploy deploy --stage myapp-stg
```
# Development
## Test locally
```bash
# prerequisites
corepack install
yarn
# run tests
yarn test
# run sources with tsx
yarn start --help
yarn start bootstrap --pwd ./test --stage myapp-dev
# build new version
yarn build
# test build
yarn start:prod --help
yarn start:dist bootstrap --pwd ./test --stage myapp-dev
# test deploy
yarn start:dist deploy --pwd ./test --stage myapp-dev
```