@pwrdrvr/microapps-app-release-cdk
v0.7.0
Published
Release app for the MicroApps framework, by PwrDrvr LLC. Provides the ability to control which version of an app is launched.
Readme
Overview
Example / basic Next.js-based Release app for the MicroApps framework.
Repo development uses Node 22 and pnpm. See CONTRIBUTING.md for local setup and common commands.
Table of Contents
Screenshot

Try the App
Video Preview of the App

Functionality
- Lists all deployed applications
- Shows all versions and rules per application
- Allows setting the
defaultrule (pointer to version) for each application
Installation
Example CDK Stack that deploys @pwrdrvr/microapps-app-release:
The application is intended to be deployed upon the MicroApps framework and it operates on a DynamoDB Table created by the MicroApps framework. Thus, it is required that there be a deployment of MicroApps that can receive this application. Deploying the MicroApps framework and general application deployment instructions are covered by the MicroApps documentation.
Important: this version of the release console updates routing state through POST requests on versioned /api/ paths. If you are deploying on a custom MicroApps CloudFront configuration, make sure those versioned /api/ routes are forwarded to the app origin with POST allowed. Otherwise dotted versions such as 0.0.0-pr.106 can be picked up by the static-file behavior and CloudFront will reject the request before it reaches the app. If you are using MicroApps 1.2.0 or newer, API route behaviors are enabled by default and no custom override should be needed.
The application is packaged for deployment via AWS CDK and consists of a single Lambda function that reads/writes the MicroApps DynamoDB Table.
The CDK construct is published for JavaScript and TypeScript via npm, with API docs available on @pwrdrvr/microapps-app-release-cdk - Construct Hub.
Installation of CDK Construct
Node.js TypeScript/JavaScript
npm i --save-dev @pwrdrvr/microapps-app-release-cdkAdd the Construct to your CDK Stack
See cdk-stack for a complete example used to deploy this app for PR builds.
import { MicroAppsAppRelease } from '@pwrdrvr/microapps-app-release-cdk';
const app = new MicroAppsAppRelease(this, 'app', {
functionName: `microapps-app-${appName}${shared.envSuffix}${shared.prSuffix}`,
table: dynamodb.Table.fromTableName(this, 'apps-table', shared.tableName),
nodeEnv: shared.env as Env,
removalPolicy: shared.isPR ? RemovalPolicy.DESTROY : RemovalPolicy.RETAIN,
});