Deployment Guide

CDN Deployment

When you make changes to src/solvpath-microform.js:

npm run build

This generates dist/solvpath-microform.min.js for CDN.

npm Package Deployment

1. Make your code changes

Edit src/solvpath-microform.js as needed.

2. Update version in package.json

"version": "1.0.1"

Follow semver:

• Patch (1.0.x): Bug fixes
• Minor (1.x.0): New features (backward compatible)
• Major (x.0.0): Breaking changes

3. Build and publish

npm run build:all
npm publish

Build Commands

| Command | Output | Purpose | |---------|--------|---------| | npm run build | dist/solvpath-microform.min.js | CDN | | npm run build:npm | dist/*.esm.js, dist/*.cjs.js | npm | | npm run build:all | Both | Full build |

Environment

The GATEWAY_BASE_URL is configured in .env:

GATEWAY_BASE_URL=https://pay.solvpath.com/

Both CDN and npm builds use this value.

Files Overview

src/solvpath-microform.js  # Source code (DO NOT create other files in src/)
index.js                   # npm entry point
index.d.ts                 # TypeScript types
build.js                   # CDN build script
build-npm.js               # npm build script