cdk-nextjs 0.4.2 → 0.4.3

package/.jsii

@@ -3984,7 +3984,7 @@
   },
   "name": "cdk-nextjs",
   "readme": {
-    "markdown": "![Version](https://img.shields.io/github/v/release/cdklabs/cdk-nextjs)\n[![npm version](https://img.shields.io/npm/v/cdk-nextjs.svg?style=flat-square)](https://www.npmjs.org/package/cdk-nextjs)\n![License](https://img.shields.io/github/license/cdklabs/cdk-nextjs)\n\n# CDK Next.js Construct Library\n\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nDeploy [Next.js](https://nextjs.org/) apps on [AWS](https://aws.amazon.com/) with the [AWS CDK](https://aws.amazon.com/cdk/).\n\n## Features\n\n- Supports all features of Next.js App and Pages Router for [Node.js Runtime](https://nextjs.org/docs/app/building-your-application/rendering/edge-and-nodejs-runtimes#nodejs-runtime). One exception is `NextjsGlobalFunctions` does not currently support [ISR](https://nextjs.org/docs/app/guides/incremental-static-regeneration) - waiting for [Official Next.js Deployment Adapters API](https://github.com/vercel/next.js/discussions/77740).\n- Choose your AWS architecture for Next.js with the supported constructs: `NextjsGlobalFunctions`, `NextjsGlobalContainers`, `NextjsRegionalContainers`.\n- Global Content Delivery Network (CDN) built with [Amazon CloudFront](https://aws.amazon.com/cloudfront/) to deliver content with low latency and high transfer speeds.\n- Serverless functions powered by [AWS Lambda](https://aws.amazon.com/lambda/) or serverless containers powered by [AWS Fargate](https://aws.amazon.com/fargate/).\n- Static assets (JS, CSS, public folder) are stored and served from [Amazon Simple Storage Service (S3)](https://aws.amazon.com/s3/) for global constructs to decrease latency and reduce compute costs.\n- [Optimized images](https://nextjs.org/docs/pages/building-your-application/optimizing/images), [data cache](https://nextjs.org/docs/app/building-your-application/caching#data-cache), and [full route cache](https://nextjs.org/docs/app/building-your-application/caching#full-route-cache) are shared across compute with [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/).\n- Customize every construct via `overrides`.\n- AWS security and operational best practices are utilized, guided by [cdk-nag](https://github.com/cdklabs/cdk-nag).\n- First class support for [monorepos](https://monorepo.tools/).\n- [AWS GovCloud (US)](https://aws.amazon.com/govcloud-us) compatible (with `NextjsRegionalContainers`).\n\n## Getting Started\n\n1. If you don’t have a Next.js project yet, follow [these steps](https://nextjs.org/docs/getting-started) to create one.\n1. Install [Docker](https://www.docker.com/). We recommend [Rancher Desktop](https://rancherdesktop.io/) with dockerd (moby) container engine enabled.\n1. Install [Node.js](https://nodejs.org/en). We recommend the long term support (LTS) version.\n1. Set your [next.config.js](https://nextjs.org/docs/pages/api-reference/next-config-js) [output](https://nextjs.org/docs/pages/api-reference/next-config-js/output) key to `\"standalone\"`. Learn more here about [Standalone Output](https://nextjs.org/docs/pages/api-reference/next-config-js/output#automatically-copying-traced-files).\n1. Setup [AWS Cloud Development Kit](https://docs.aws.amazon.com/cdk/v2/guide/home.html) app.\n1. Install the construct package: `npm install cdk-nextjs`\n1. `cdk deploy`\n1. Visit URL printed in terminal (CloudFormation Output) to view your Next.js app!\n\n## Basic Example CDK App\n\n```ts\nimport { App, Stack, StackProps } from \"aws-cdk-lib\";\nimport { Construct } from \"constructs\";\nimport { NextjsGlobalFunctions } from \"cdk-nextjs\";\nimport { join } from \"node:path\";\n\nclass NextjsStack extends Stack {\n  constructor(scope: Construct, id: string, props?: StackProps) {\n    super(scope, id, props);\n    new NextjsGlobalFunctions(this, \"Nextjs\", {\n      healthCheckPath: \"/api/health\",\n      buildContext: join(import.meta.dirname, \"..\"),\n    });\n  }\n}\n\nconst app = new App();\n\nnew NextjsStack(app, \"nextjs\");\n```\n\nSee [examples/](./examples/) for more usage examples.\n\n## Architecture\n\n### `NextjsGlobalFunctions`\n\nArchitecture includes [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) Functions to respond to dynamic requests and [CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) Distribution to globally serve requests and distribute static assets. Use this construct when you have unpredictable traffic, can afford occasional latency (i.e. cold starts - [typically 1% of production traffic](https://aws.amazon.com/blogs/compute/operating-lambda-performance-optimization-part-1/)), and/or want the most granular pricing model. ([code](./src/root-constructs/nextjs-global-functions.ts#L81))\n\n![NextjsGlobalFunctions](./docs/cdk-nextjs-NextjsGlobalFunctions.png)\n\n### `NextjsGlobalContainers`\n\nArchitecture includes [ECS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) containers to respond to dynamic requests and [CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) Distribution to globally serve requests and distribute static assets. Use this option when you have predictable traffic, need the lowest latency, and/or can afford a less granular pricing model. ([code](./src/root-constructs/nextjs-global-containers.ts#L76))\n\n![NextjsGlobalContainers](./docs/cdk-nextjs-NextjsGlobalContainers.png)\n\n### `NextjsRegionalContainers`\n\nArchitecture includes [ECS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) containers to respond to dynamic requests and [Application Load Balancer](https://aws.amazon.com/elasticloadbalancing/application-load-balancer/) to regionally serve requests. Use this options when you cannot use Amazon CloudFront (i.e. [AWS GovCloud](https://aws.amazon.com/govcloud-us/?whats-new.sort-by=item.additionalFields.postDateTime&whats-new.sort-order=desc)). ([code](./src/root-constructs/nextjs-regional-containers.ts#L41))\n\n![NextjsRegionalContainers](./docs/cdk-nextjs-NextjsRegionalContainers.png)\n\n## Why\n\nThe simplest path to deploy Next.js is on [Vercel](https://vercel.com/) - the Platform-as-a-Service company behind Next.js. However, deploying to Vercel can be expensive and some developers want all of their workloads running _directly_ on AWS. Developers can deploy Next.js on AWS through [AWS Amplify Hosting](https://docs.aws.amazon.com/amplify/latest/userguide/ssr-Amplifysupport.html), but Amplify does not support all Next.js features and manages AWS resources for you so they cannot be customized. If Amplify meets your requirements we recommend you use it, but if you want to use all Next.js features or want more visibility into the AWS resources then this construct is for you.\n\n## Design Principles\n\n- Treat Next.js as black box. Minimize reliance on Next.js internal APIs to reduce chance of incompatibility between this construct and future versions of Next.js.\n- Security first.\n- One architecture does not fit all.\n- Enable customization everywhere.\n\n## Limitations\n\n- If using `NextjsGlobalFunctions` or `NextjsGlobalContainers` (which use CloudFront), the number of top level files/directories cannot exceed 25, the max number of behaviors a CloudFront Distrubtion supports. We recommend you put all of your public assets into one top level directory (i.e. public/static) so you don't reach this limit. See [CloudFront Quotas](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) for more information.\n- If using `NextjsGlobalFunctions`, when [revalidating data in Next.js](https://nextjs.org/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating#on-demand-revalidation) (i.e. [revalidatePath](https://nextjs.org/docs/app/api-reference/functions/revalidatePath)), the CloudFront Cache will still hold stale data. You'll need to use AWS SDK JS V3 [CreateInvalidationCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudfront/Class/CreateInvalidationCommand/) to manually invalidate the path in CloudFront. See more [here](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html).\n- If using `NextjsGlobalFunctions`, setting an Authorization header won't work by default because of Lambda Function URL with IAM Auth is already using the Authorization header. You can use the `AWS_LWA_AUTHORIZATION_SOURCE` environment variable of [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter) to set an alternative Authorization header in the client which will then be set to the Authorization header when it reaches your app.\n\n## Additional Security Recommendations\n\nThis construct by default implements all AWS security best practices that a CDK construct library reasonably can considering cost and complexity. Below are additional security practices we recommend you implement within your CDK app. Please see them below:\n\n- [VPC Flow Logs](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html). See [examples/](./examples) for sample implementation.\n- [Scan ECR Images For Vulnerabilities](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html).\n- For `NextjsGlobalFunctions` and `NextjsGlobalContainers`, [CloudFront Access Logs](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html). See [examples/](./examples) for sample implementation.\n- For `NextjsGlobalContainers` and `NextjsRegionalContainers`, [ALB HTTPS Listener](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html)\n- If using `NextjsGlobalContainers`, enable `ReadonlyRootFilesystem`. This will remove ability to use Static On-Demand feature of Next.js so it's not enabled by default, but is recommended for security.\n\n## Estimated Costs\n\n### Assumptions\n\nThe following basic assumptions were used for a typical medium Next.js app. See [docs/usage.xlsx](./docs/usage.xlsx) for detailed assumptions and usage per construct type that you can plug into AWS Pricing Calculator.\n\n| Metric                                                       | Value |\n| ------------------------------------------------------------ | ----- |\n| Monthly Active Users                                         | 1K    |\n| Pages Visited Per Month Per User                             | 100   |\n| Avg Request Size                                             | 50KB  |\n| Static Requests Per Page (js, css, etc)                      | 15    |\n| Static Requests Cache Hit %                                  | 50%   |\n| Static Assets Size                                           | 10GB  |\n| Dynamic Requests Per Page (document, optimized images, etc.) | 5     |\n| Dynamic Cache Read %                                         | 50%   |\n| Dynamic Cache Write %                                        | 5%    |\n| Dynamic Cache Data Size                                      | 10GB  |\n| Average Dynamic Cache Request Size                           | 100KB |\n\nMore Details:\n\n- Assume ARM architecture for compute\n- AWS Region: us-east-1\n- Excludes charges related to: CloudWatch Logs, NAT Gateway data processing\n\n#### NAT Gateway and Alternatives\n\n[NAT Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) enable compute within private subnets to access the internet without directly exposing that compute to the internet. NAT Gateways prevent you from having to manage your own NAT Instances however they cost $0.045/hr/AZ resulting in charge of $64.80/month for 2 AZs (.045 x 24 x 30 x 2). While NAT Gateways are recommended by AWS to ensure maximum reliability and scalability, some customers may desire less expensive alternatives:\n\n1. $0.00 - if you're Next.js app does not need to access the internet, remove the NAT Gateway.\n2. $6.05 - managing your own [NAT Instance](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html). See [examples/low-cost](./examples/low-cost/) for how to use [fck-nat](https://fck-nat.dev/stable/).\n3. $32.40 - use 1 AZ instead of 2.\n\n### NextjsGlobalFunctions\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=cbabcb1142ad9b29345b82b33b3cf552eddc966a)\n\n| Service    | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ---------- | ---------------------------------------------- | ---------------------------- |\n| Lambda     | 500K requests, 2 GB memory, 150ms avg duration | $0.00 (Always Free Tier)     |\n| CloudFront | 2M requests, 100 GB transfer to internet       | $0.00 (Always Free Tier)     |\n| S3         | 10 GB storage, 750K GET requests               | $0.53                        |\n| EFS        | 10 GB storage, 25/2.5 GB Read/Write Throughput | $3.90                        |\n| VPC        | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total      |                                                | $69.32                       |\n\n### NextjsGlobalContainers\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=1354220e3d611a726139bee4af4277debacd365c)\n\n| Service     | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ----------- | ---------------------------------------------- | ---------------------------- |\n| ECS Fargate | 1 task (1 vCPU, 2 GB)                          | $28.44                       |\n| ALB         | 1 LB, 1.04GB/hr, 5.79 conn/sec                 | $22.50                       |\n| CloudFront  | 2M requests, 100 GB transfer to internet       | $0.00 (Always Free Tier)     |\n| S3          | 10 GB storage, 750K GET requests               | $0.53                        |\n| EFS         | 10 GB storage, 25/2.5 GB Read/Write Throughput | $3.90                        |\n| VPC         | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total       |                                                | $120.53                      |\n\n### NextjsRegionalContainers\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=f53440707350f74cf478ca9e45a3ad32f5e16710)\n\n| Service     | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ----------- | ---------------------------------------------- | ---------------------------- |\n| ECS Fargate | 1 task (2 vCPU, 4 GB), always on               | $28.44                       |\n| ALB         | 1 LB, 4.17 GB/hr, 23.15 conn/sec               | $40.78                       |\n| EFS         | 10 GB storage, 25/2.5 GB Read/Write Throughput | $4.05                        |\n| VPC         | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total       |                                                | $138.07                      |\n\n## Performance\n\n[Artillery Playwright](https://www.artillery.io/docs/reference/engines/playwright#overview) app playground example load tests results with 1K concurrent users. Reproduce with `pnpm test-fargate:lg` within `examples/load-tests`.\n\n### NextjsGlobalFunctions\n\n<details>\n<summary>`NextjsGlobalFunctions` Performance Details</summary>\n\n```bash\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr:\n  min: ......................................................................... 6.3\n  max: ......................................................................... 5017.4\n  mean: ........................................................................ 11.5\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 22.9\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/1:\n  min: ......................................................................... 3.2\n  max: ......................................................................... 560.6\n  mean: ........................................................................ 9.4\n  median: ...................................................................... 5.4\n  p95: ......................................................................... 11.1\n  p99: ......................................................................... 162.4\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/2:\n  min: ......................................................................... 3.1\n  max: ......................................................................... 1511.9\n  mean: ........................................................................ 9.2\n  median: ...................................................................... 5.2\n  p95: ......................................................................... 10.7\n  p99: ......................................................................... 149.9\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/3:\n  min: ......................................................................... 3.4\n  max: ......................................................................... 131.1\n  mean: ........................................................................ 7.1\n  median: ...................................................................... 5.3\n  p95: ......................................................................... 10.1\n  p99: ......................................................................... 64.7\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssg:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5015.1\n  mean: ........................................................................ 11.5\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssg/3:\n  min: ......................................................................... 2.9\n  max: ......................................................................... 98\n  mean: ........................................................................ 5.1\n  median: ...................................................................... 4.6\n  p95: ......................................................................... 8.2\n  p99: ......................................................................... 12.8\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssr:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5018.6\n  mean: ........................................................................ 11.3\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssr/2:\n  min: ......................................................................... 83.4\n  max: ......................................................................... 150.7\n  mean: ........................................................................ 119\n  median: ...................................................................... 111.1\n  p95: ......................................................................... 147\n  p99: ......................................................................... 147\nbrowser.page.TTFB.https://abc123.cloudfront.net/streaming:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5015.2\n  mean: ........................................................................ 11.8\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\n```\n\n</details>\n\n![1K concurrent users](./docs/1k-concurrent-users-executions.png)\n\n### NextjsGlobalContainers\n\n<details>\n<summary>`NextjsGlobalContainers` Performance Details</summary>\n\n```bash\nTODO\n```\n\n</details>\n\n### NextjsRegionalContainers\n\n<details>\n<summary>`NextjsRegionalContainers` Performance Details</summary>\n\n```bash\nTODO\n```\n\n</details>\n\n## Contributing\n\nSteps to build locally:\n\n1. `git clone https://github.com/cdklabs/cdk-nextjs.git`\n2. `cd cdk-nextjs`\n3. `pnpm i && pnpm compile && pnpm build`\n\nThis project uses Projen, so make sure to not edit [Projen](https://projen.io/) created files and only edit .projenrc.ts.\n\n## FAQ\n\nQ: How does this compare to [cdk-nextjs-standalone](https://github.com/jetbridge/cdk-nextjs)?<br/>\nA: cdk-nextjs-standalone relies on [OpenNext](https://github.com/sst/open-next). OpenNext injects custom code to interact with private Next.js APIs. While OpenNext is able to make some optimizations that are great for serverless environments, this comes at an increase maintenance cost and increased chances for breaking changes. A goal of cdk-nextjs is to customize Next.js as little as possible to reduce the maintenance burden and decrease chances of breaking changes.\n\nQ: Why not offer API Gateway version of construct?<br/>\nA: API Gateway does not support streaming.\n\nQ: How does cdk-nextjs support caching in Next.js?<br/>\nA: Next.js has 3 types of server caching that are persisted to disk: [data cache](https://nextjs.org/docs/app/building-your-application/caching#data-cache), [full route cache](https://nextjs.org/docs/app/building-your-application/caching#full-route-cache), and [image optimization cache](https://nextjs.org/docs/pages/building-your-application/optimizing/images). By default this cached data is persisted on individual compute instances and is not shared - reducing cache hits. cdk-nextjs uses the [custom Next.js cache handler](https://nextjs.org/docs/app/api-reference/next-config-js/incrementalCacheHandlerPath) for data and full route cache and symlinking for image optimization cache to modify Next.js to read/write from a mounted file system\n\nQ: Why EFS instead of S3?<br/>\nA: cdk-nextjs uses [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/) to mount a file system to functions or containers as a shared cache. The custom Next.js cache handler could be modified to read/write data to [Amazon S3](https://aws.amazon.com/pm/serv-s3), but there is no way to modify the location of the image optimization cache without modifying Next.js internals. Other factors to compare:\n\n| Factor                        | EFS                       | S3                    |\n| ----------------------------- | ------------------------- | --------------------- |\n| Performance                   | 1-10ms per file operation | 100-200ms per request |\n| Cold Start Impact             | 50-100ms to mount         | No impact             |\n| Storage Cost                  | $0.30 / GB-month          | $0.023 / GB-month     |\n| Read Throughput/Request Cost  | $0.03 / GB-month          | $0.04 / M requests    |\n| Write Throughput/Request Cost | $0.06 / GB-month          | $5.00 / M requests    |\n\nQ: How customizable is the `cdk-nextjs` package for different use cases?<br/>\nA: The `cdk-nextjs` package offers deep customization through _prop-based_ overrides. These can be accessed in the construct props, allowing you to override settings like VPC configurations, CloudFront distribution, and ECS/Fargate setup. For example, you can modify `nextjsBuildProps` to customize the build process or use `nextjsDistributionProps` to adjust how CloudFront handles caching and routing. This level of control makes it easy to adapt the infrastructure to your application’s specific performance, networking, or deployment needs.\n\nQ: How can I use a custom domain with `cdk-nextjs`?<br/>\nA: See [low-cost example](./examples/low-cost/app.ts).\n\nQ: What is difference between `NextjsGlobalFunctionsProps.overrides.nextjsDistribution` and `NextjsGlobalFunctionsProps.overrides.nextjsGlobalFunctions.nextjsDistributionProps`<br/>\nA: `NextjsGlobalFunctionsProps.overrides.nextjsDistribution` allows you to customize any construct's props _within_ `NextjsDistribution` and is likely what you want whereas `NextjsGlobalFunctionsProps.overrides.nextjsGlobalFunctions.nextjsDistributionProps` allows you to customize the props passed into the construct: `NextjsDistribution`. This principle also applies to other similarly named overrides.\n\nQ: Why use container image for `NextjsGlobalFunctions`?<br />\nA: Read [The case for containers on Lambda (with benchmarks)](https://aaronstuyvenberg.com/posts/containers-on-lambda).\n\n## Acknowledgements\n\nThis construct was built on the shoulders of giants. Thank you to the contributors of [cdk-nextjs-standalone](https://github.com/jetbridge/cdk-nextjs) and [open-next](https://github.com/sst/open-next).\n\n## 🥂 Thanks Contributors\n\nThank you for helping other developers deploy Next.js apps on AWS\n\n<a href=\"https://github.com/cdklabs/cdk-nextjs/graphs/contributors\">\n  <img src=\"https://contrib.rocks/image?repo=cdklabs/cdk-nextjs\" />\n</a>\n"
+    "markdown": "![Version](https://img.shields.io/github/v/release/cdklabs/cdk-nextjs)\n[![npm version](https://img.shields.io/npm/v/cdk-nextjs.svg?style=flat-square)](https://www.npmjs.org/package/cdk-nextjs)\n![License](https://img.shields.io/github/license/cdklabs/cdk-nextjs)\n\n# CDK Next.js Construct Library\n\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nDeploy [Next.js](https://nextjs.org/) apps on [AWS](https://aws.amazon.com/) with the [AWS CDK](https://aws.amazon.com/cdk/).\n\n## Features\n\n- Supports all features of Next.js App and Pages Router for [Node.js Runtime](https://nextjs.org/docs/app/building-your-application/rendering/edge-and-nodejs-runtimes#nodejs-runtime). One exception is `NextjsGlobalFunctions` does not currently support [ISR](https://nextjs.org/docs/app/guides/incremental-static-regeneration) - waiting for [Official Next.js Deployment Adapters API](https://github.com/vercel/next.js/discussions/77740).\n- Choose your AWS architecture for Next.js with the supported constructs: `NextjsGlobalFunctions`, `NextjsGlobalContainers`, `NextjsRegionalContainers`.\n- Global Content Delivery Network (CDN) built with [Amazon CloudFront](https://aws.amazon.com/cloudfront/) to deliver content with low latency and high transfer speeds.\n- Serverless functions powered by [AWS Lambda](https://aws.amazon.com/lambda/) or serverless containers powered by [AWS Fargate](https://aws.amazon.com/fargate/).\n- Static assets (JS, CSS, public folder) are stored and served from [Amazon Simple Storage Service (S3)](https://aws.amazon.com/s3/) for global constructs to decrease latency and reduce compute costs.\n- [Optimized images](https://nextjs.org/docs/pages/building-your-application/optimizing/images), [data cache](https://nextjs.org/docs/app/building-your-application/caching#data-cache), and [full route cache](https://nextjs.org/docs/app/building-your-application/caching#full-route-cache) are shared across compute with [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/).\n- Customize every construct via `overrides`.\n- AWS security and operational best practices are utilized, guided by [cdk-nag](https://github.com/cdklabs/cdk-nag).\n- First class support for [monorepos](https://monorepo.tools/).\n- [AWS GovCloud (US)](https://aws.amazon.com/govcloud-us) compatible (with `NextjsRegionalContainers`).\n\n## Getting Started\n\n1. If you don’t have a Next.js project yet, follow [these steps](https://nextjs.org/docs/getting-started) to create one.\n1. Install [Docker](https://www.docker.com/). We recommend [Rancher Desktop](https://rancherdesktop.io/) with dockerd (moby) container engine enabled.\n1. Install [Node.js](https://nodejs.org/en). We recommend the long term support (LTS) version.\n1. Set your [next.config.js](https://nextjs.org/docs/pages/api-reference/next-config-js) [output](https://nextjs.org/docs/pages/api-reference/next-config-js/output) key to `\"standalone\"`. Learn more here about [Standalone Output](https://nextjs.org/docs/pages/api-reference/next-config-js/output#automatically-copying-traced-files).\n1. Setup [AWS Cloud Development Kit](https://docs.aws.amazon.com/cdk/v2/guide/home.html) app.\n1. Install the construct package: `npm install cdk-nextjs`\n1. `cdk deploy`\n1. Visit URL printed in terminal (CloudFormation Output) to view your Next.js app!\n\n## Basic Example CDK App\n\n```ts\nimport { App, Stack, StackProps } from \"aws-cdk-lib\";\nimport { Construct } from \"constructs\";\nimport { NextjsGlobalFunctions } from \"cdk-nextjs\";\nimport { join } from \"node:path\";\n\nclass NextjsStack extends Stack {\n  constructor(scope: Construct, id: string, props?: StackProps) {\n    super(scope, id, props);\n    new NextjsGlobalFunctions(this, \"Nextjs\", {\n      healthCheckPath: \"/api/health\",\n      buildContext: join(import.meta.dirname, \"..\"),\n    });\n  }\n}\n\nconst app = new App();\n\nnew NextjsStack(app, \"nextjs\");\n```\n\nSee [examples/](./examples/) for more usage examples.\n\n## Architecture\n\n### `NextjsGlobalFunctions`\n\nArchitecture includes [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) Functions to respond to dynamic requests and [CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) Distribution to globally serve requests and distribute static assets. Use this construct when you have unpredictable traffic, can afford occasional latency (i.e. cold starts - [typically 1% of production traffic](https://aws.amazon.com/blogs/compute/operating-lambda-performance-optimization-part-1/)), and/or want the most granular pricing model. ([code](./src/root-constructs/nextjs-global-functions.ts))\n\n![NextjsGlobalFunctions](./docs/cdk-nextjs-NextjsGlobalFunctions.png)\n\n### `NextjsGlobalContainers`\n\nArchitecture includes [ECS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) containers to respond to dynamic requests and [CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) Distribution to globally serve requests and distribute static assets. Use this option when you have predictable traffic, need the lowest latency, and/or can afford a less granular pricing model. ([code](./src/root-constructs/nextjs-global-containers.ts))\n\n![NextjsGlobalContainers](./docs/cdk-nextjs-NextjsGlobalContainers.png)\n\n### `NextjsRegionalContainers`\n\nArchitecture includes [ECS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) containers to respond to dynamic requests and [Application Load Balancer](https://aws.amazon.com/elasticloadbalancing/application-load-balancer/) to regionally serve requests. Use this options when you cannot use Amazon CloudFront (i.e. [AWS GovCloud](https://aws.amazon.com/govcloud-us/?whats-new.sort-by=item.additionalFields.postDateTime&whats-new.sort-order=desc)). ([code](./src/root-constructs/nextjs-regional-containers.ts#L41))\n\n![NextjsRegionalContainers](./docs/cdk-nextjs-NextjsRegionalContainers.png)\n\n### `NextjsRegionalFunctions`\n\nArchitecture includes [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) Functions to respond to dynamic requests and [API Gateway REST API](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-rest-api.html) to regionally serve requests and distribute static assets. Use this options when you cannot use Amazon CloudFront (i.e. [AWS GovCloud](https://aws.amazon.com/govcloud-us/?whats-new.sort-by=item.additionalFields.postDateTime&whats-new.sort-order=desc)). ([code](./src/root-constructs/nextjs-regional-functions.ts))\n\n![NextjsRegionalFunctions](./docs/cdk-nextjs-NextjsRegionalFunctions.png)\n\n## Why\n\nThe simplest path to deploy Next.js is on [Vercel](https://vercel.com/) - the Platform-as-a-Service company behind Next.js. However, deploying to Vercel can be expensive and some developers want all of their workloads running _directly_ on AWS. Developers can deploy Next.js on AWS through [AWS Amplify Hosting](https://docs.aws.amazon.com/amplify/latest/userguide/ssr-Amplifysupport.html), but Amplify does not support all Next.js features and manages AWS resources for you so they cannot be customized. If Amplify meets your requirements we recommend you use it, but if you want to use all Next.js features or want more visibility into the AWS resources then this construct is for you.\n\n## Design Principles\n\n- Treat Next.js as black box. Minimize reliance on Next.js internal APIs to reduce chance of incompatibility between this construct and future versions of Next.js.\n- Security first.\n- One architecture does not fit all.\n- Enable customization everywhere.\n\n## Limitations\n\n- If using `NextjsGlobalFunctions` or `NextjsGlobalContainers` (which use CloudFront), the number of top level files/directories cannot exceed 25, the max number of behaviors a CloudFront Distribution supports. We recommend you put all of your public assets into one top level directory (i.e. public/static) so you don't reach this limit. See [CloudFront Quotas](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) for more information.\n- If using `NextjsGlobalFunctions`, when [revalidating data in Next.js](https://nextjs.org/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating#on-demand-revalidation) (i.e. [revalidatePath](https://nextjs.org/docs/app/api-reference/functions/revalidatePath)), the CloudFront Cache will still hold stale data. You'll need to use AWS SDK JS V3 [CreateInvalidationCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudfront/Class/CreateInvalidationCommand/) to manually invalidate the path in CloudFront. See more [here](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html).\n- If using `NextjsGlobalFunctions`, setting an Authorization header won't work by default because of Lambda Function URL with IAM Auth is already using the Authorization header. You can use the `AWS_LWA_AUTHORIZATION_SOURCE` environment variable of [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter) to set an alternative Authorization header in the client which will then be set to the Authorization header when it reaches your app.\n- `NextjsRegionalFunctions` doesn't support streaming because API Gateway doesn't support streaming yet.\n- If using `NextjsRegionalFunctions` without a custom domain, API Gateway REST APIs require a [stage name](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-stages.html) (default: `/prod`) to be specified. This causes links to pages and static assets to break because they're not prefixed with the stage name. You can work around this issue by specifying [basePath](https://nextjs.org/docs/app/api-reference/config/next-config-js/basePath) in next.config.js as your stage name. Additionally, you'll need to add middleware logic to rewrite requests to include the stage name because API Gateway does not include the stage name in the path passed to Lambda. See [examples/app-playground/middleware.ts](./examples/app-playground/middleware.ts).\n\n## Additional Security Recommendations\n\nThis construct by default implements all AWS security best practices that a CDK construct library reasonably can considering cost and complexity. Below are additional security practices we recommend you implement within your CDK app. Please see them below:\n\n- [VPC Flow Logs](https://docs.aws.amazon.com/vpc/latest/userguide/flow-logs.html). See [examples/](./examples) for sample implementation.\n- [Scan ECR Images For Vulnerabilities](https://docs.aws.amazon.com/AmazonECR/latest/userguide/image-scanning.html).\n- For `NextjsGlobalFunctions` and `NextjsGlobalContainers`, [CloudFront Access Logs](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html). See [examples/](./examples) for sample implementation.\n- For `NextjsGlobalContainers` and `NextjsRegionalContainers`, use [ALB HTTPS Listener](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html)\n- If using `NextjsGlobalContainers` and `NextjsRegionalContainers`, enable `ReadonlyRootFilesystem`. This will remove ability to use Static On-Demand feature of Next.js so it's not enabled by default, but is recommended for security.\n\n## Estimated Costs\n\n### Assumptions\n\nThe following basic assumptions were used for a typical medium Next.js app. See [docs/usage.xlsx](./docs/usage.xlsx) for detailed assumptions and usage per construct type that you can plug into AWS Pricing Calculator.\n\n| Metric                                                       | Value |\n| ------------------------------------------------------------ | ----- |\n| Monthly Active Users                                         | 1K    |\n| Pages Visited Per Month Per User                             | 100   |\n| Avg Request Size                                             | 50KB  |\n| Static Requests Per Page (js, css, etc)                      | 15    |\n| Static Requests Cache Hit %                                  | 50%   |\n| Static Assets Size                                           | 10GB  |\n| Dynamic Requests Per Page (document, optimized images, etc.) | 5     |\n| Dynamic Cache Read %                                         | 50%   |\n| Dynamic Cache Write %                                        | 5%    |\n| Dynamic Cache Data Size                                      | 10GB  |\n| Average Dynamic Cache Request Size                           | 100KB |\n\nMore Details:\n\n- Assume ARM architecture for compute\n- AWS Region: us-east-1\n- Excludes charges related to: CloudWatch Logs, NAT Gateway data processing\n\n#### NAT Gateway and Alternatives\n\n[NAT Gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html) enable compute within private subnets to access the internet without directly exposing that compute to the internet. NAT Gateways prevent you from having to manage your own NAT Instances however they cost $0.045/hr/AZ resulting in charge of $64.80/month for 2 AZs (.045 x 24 x 30 x 2). While NAT Gateways are recommended by AWS to ensure maximum reliability and scalability, some customers may desire less expensive alternatives:\n\n1. $0.00 - if you're Next.js app does not need to access the internet, remove the NAT Gateway.\n2. $6.05 - managing your own [NAT Instance](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html). See [examples/low-cost](./examples/low-cost/) for how to use [fck-nat](https://fck-nat.dev/stable/).\n3. $32.40 - use 1 AZ instead of 2.\n\n### NextjsGlobalFunctions\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=cbabcb1142ad9b29345b82b33b3cf552eddc966a)\n\n| Service    | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ---------- | ---------------------------------------------- | ---------------------------- |\n| Lambda     | 500K requests, 2 GB memory, 150ms avg duration | $0.00 (Always Free Tier)     |\n| CloudFront | 2M requests, 100 GB transfer to internet       | $0.00 (Always Free Tier)     |\n| S3         | 10 GB storage, 750K GET requests               | $0.53                        |\n| EFS        | 10 GB storage, 25/2.5 GB Read/Write Throughput | $3.90                        |\n| VPC        | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total      |                                                | $69.32                       |\n\n### NextjsGlobalContainers\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=1354220e3d611a726139bee4af4277debacd365c)\n\n| Service     | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ----------- | ---------------------------------------------- | ---------------------------- |\n| ECS Fargate | 1 task (1 vCPU, 2 GB)                          | $28.44                       |\n| ALB         | 1 LB, 1.04GB/hr, 5.79 conn/sec                 | $22.50                       |\n| CloudFront  | 2M requests, 100 GB transfer to internet       | $0.00 (Always Free Tier)     |\n| S3          | 10 GB storage, 750K GET requests               | $0.53                        |\n| EFS         | 10 GB storage, 25/2.5 GB Read/Write Throughput | $3.90                        |\n| VPC         | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total       |                                                | $120.53                      |\n\n### NextjsRegionalContainers\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=f53440707350f74cf478ca9e45a3ad32f5e16710)\n\n| Service     | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ----------- | ---------------------------------------------- | ---------------------------- |\n| ECS Fargate | 1 task (2 vCPU, 4 GB), always on               | $28.44                       |\n| ALB         | 1 LB, 4.17 GB/hr, 23.15 conn/sec               | $40.78                       |\n| EFS         | 10 GB storage, 25/2.5 GB Read/Write Throughput | $4.05                        |\n| VPC         | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total       |                                                | $138.07                      |\n\n### NextjsRegionalFunctions\n\n[AWS Pricing Calculator](https://calculator.aws/#/estimate?id=a6d21afbb983c7efa53da096aa608739da113247)\n\n| Service     | Monthly Usage                                  | Estimated Monthly Cost (USD) |\n| ----------- | ---------------------------------------------- | ---------------------------- |\n| Lambda      | 500K requests, 2 GB memory, 150ms avg duration | $0.00 (Always Free Tier)     |\n| API Gateway | 2M requests                                    | $7.00                        |\n| EFS         | 10 GB storage, 25/2.5 GB Read/Write Throughput | $4.05                        |\n| VPC         | NAT Gateway, 2 AZs                             | $64.80                       |\n| Total       |                                                | $75.85                       |\n\n## Performance\n\n[Artillery Playwright](https://www.artillery.io/docs/reference/engines/playwright#overview) app playground example load tests results with 1K concurrent users. Reproduce with `pnpm test-fargate:lg` within `examples/load-tests`.\n\n### NextjsGlobalFunctions\n\n<details>\n<summary>`NextjsGlobalFunctions` Performance Details</summary>\n\n```bash\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr:\n  min: ......................................................................... 6.3\n  max: ......................................................................... 5017.4\n  mean: ........................................................................ 11.5\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 22.9\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/1:\n  min: ......................................................................... 3.2\n  max: ......................................................................... 560.6\n  mean: ........................................................................ 9.4\n  median: ...................................................................... 5.4\n  p95: ......................................................................... 11.1\n  p99: ......................................................................... 162.4\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/2:\n  min: ......................................................................... 3.1\n  max: ......................................................................... 1511.9\n  mean: ........................................................................ 9.2\n  median: ...................................................................... 5.2\n  p95: ......................................................................... 10.7\n  p99: ......................................................................... 149.9\nbrowser.page.TTFB.https://abc123.cloudfront.net/isr/3:\n  min: ......................................................................... 3.4\n  max: ......................................................................... 131.1\n  mean: ........................................................................ 7.1\n  median: ...................................................................... 5.3\n  p95: ......................................................................... 10.1\n  p99: ......................................................................... 64.7\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssg:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5015.1\n  mean: ........................................................................ 11.5\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssg/3:\n  min: ......................................................................... 2.9\n  max: ......................................................................... 98\n  mean: ........................................................................ 5.1\n  median: ...................................................................... 4.6\n  p95: ......................................................................... 8.2\n  p99: ......................................................................... 12.8\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssr:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5018.6\n  mean: ........................................................................ 11.3\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\nbrowser.page.TTFB.https://abc123.cloudfront.net/ssr/2:\n  min: ......................................................................... 83.4\n  max: ......................................................................... 150.7\n  mean: ........................................................................ 119\n  median: ...................................................................... 111.1\n  p95: ......................................................................... 147\n  p99: ......................................................................... 147\nbrowser.page.TTFB.https://abc123.cloudfront.net/streaming:\n  min: ......................................................................... 6.4\n  max: ......................................................................... 5015.2\n  mean: ........................................................................ 11.8\n  median: ...................................................................... 10.3\n  p95: ......................................................................... 15.6\n  p99: ......................................................................... 23.3\n```\n\n</details>\n\n![1K concurrent users](./docs/1k-concurrent-users-executions.png)\n\n### NextjsGlobalContainers\n\n<details>\n<summary>`NextjsGlobalContainers` Performance Details</summary>\n\n```bash\nTODO\n```\n\n</details>\n\n### NextjsRegionalContainers\n\n<details>\n<summary>`NextjsRegionalContainers` Performance Details</summary>\n\n```bash\nTODO\n```\n\n### NextjsRegionalFunctions\n\n<details>\n<summary>`NextjsRegionalFunctions` Performance Details</summary>\n\n```bash\nTODO\n```\n\n</details>\n\n## Contributing\n\nSteps to build locally:\n\n1. `git clone https://github.com/cdklabs/cdk-nextjs.git`\n2. `cd cdk-nextjs`\n3. `pnpm i && pnpm compile && pnpm build`\n\nThis project uses Projen, so make sure to not edit [Projen](https://projen.io/) created files and only edit .projenrc.ts.\n\n## FAQ\n\nQ: How does this compare to [cdk-nextjs-standalone](https://github.com/jetbridge/cdk-nextjs)?<br/>\nA: cdk-nextjs-standalone relies on [OpenNext](https://github.com/sst/open-next). OpenNext injects custom code to interact with private Next.js APIs. While OpenNext is able to make some optimizations that are great for serverless environments, this comes at an increase maintenance cost and increased chances for breaking changes. A goal of cdk-nextjs is to customize Next.js as little as possible to reduce the maintenance burden and decrease chances of breaking changes.\n\nQ: Why not offer API Gateway version of construct?<br/>\nA: API Gateway does not support streaming.\n\nQ: How does cdk-nextjs support caching in Next.js?<br/>\nA: Next.js has 3 types of server caching that are persisted to disk: [data cache](https://nextjs.org/docs/app/building-your-application/caching#data-cache), [full route cache](https://nextjs.org/docs/app/building-your-application/caching#full-route-cache), and [image optimization cache](https://nextjs.org/docs/pages/building-your-application/optimizing/images). By default this cached data is persisted on individual compute instances and is not shared - reducing cache hits. cdk-nextjs uses the [custom Next.js cache handler](https://nextjs.org/docs/app/api-reference/next-config-js/incrementalCacheHandlerPath) for data and full route cache and symlinking for image optimization cache to modify Next.js to read/write from a mounted file system\n\nQ: Why EFS instead of S3?<br/>\nA: cdk-nextjs uses [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/) to mount a file system to functions or containers as a shared cache. The custom Next.js cache handler could be modified to read/write data to [Amazon S3](https://aws.amazon.com/pm/serv-s3), but there is no way to modify the location of the image optimization cache without modifying Next.js internals. Other factors to compare:\n\n| Factor                        | EFS                       | S3                    |\n| ----------------------------- | ------------------------- | --------------------- |\n| Performance                   | 1-10ms per file operation | 100-200ms per request |\n| Cold Start Impact             | 50-100ms to mount         | No impact             |\n| Storage Cost                  | $0.30 / GB-month          | $0.023 / GB-month     |\n| Read Throughput/Request Cost  | $0.03 / GB-month          | $0.04 / M requests    |\n| Write Throughput/Request Cost | $0.06 / GB-month          | $5.00 / M requests    |\n\nQ: How customizable is the `cdk-nextjs` package for different use cases?<br/>\nA: The `cdk-nextjs` package offers deep customization through _prop-based_ overrides. These can be accessed in the construct props, allowing you to override settings like VPC configurations, CloudFront distribution, and ECS/Fargate setup. For example, you can modify `nextjsBuildProps` to customize the build process or use `nextjsDistributionProps` to adjust how CloudFront handles caching and routing. This level of control makes it easy to adapt the infrastructure to your application’s specific performance, networking, or deployment needs.\n\nQ: How can I use a custom domain with `cdk-nextjs`?<br/>\nA: See [low-cost example](./examples/low-cost/app.ts).\n\nQ: What is difference between `NextjsGlobalFunctionsProps.overrides.nextjsDistribution` and `NextjsGlobalFunctionsProps.overrides.nextjsGlobalFunctions.nextjsDistributionProps`<br/>\nA: `NextjsGlobalFunctionsProps.overrides.nextjsDistribution` allows you to customize any construct's props _within_ `NextjsDistribution` and is likely what you want whereas `NextjsGlobalFunctionsProps.overrides.nextjsGlobalFunctions.nextjsDistributionProps` allows you to customize the props passed into the construct: `NextjsDistribution`. This principle also applies to other similarly named overrides.\n\nQ: Why use container image for `NextjsGlobalFunctions`?<br />\nA: Read [The case for containers on Lambda (with benchmarks)](https://aaronstuyvenberg.com/posts/containers-on-lambda).\n\nQ: How can I `cdk bootstrap --cloudformation-execution-policies ...` my AWS Account with limited permissions for cdk-nextjs to deploy?<br />\nA: See [docs/cdk-nextjs-cfn-exec-policy.json](./docs/cdk-nextjs-cfn-exec-policy.json). Note, this IAM Policy is scoped to all cdk-nextjs constructs so you can remove services if you know the construct you're using doesn't use that service.\n\n## Acknowledgements\n\nThis construct was built on the shoulders of giants. Thank you to the contributors of [cdk-nextjs-standalone](https://github.com/jetbridge/cdk-nextjs) and [open-next](https://github.com/sst/open-next).\n\n## 🥂 Thanks Contributors\n\nThank you for helping other developers deploy Next.js apps on AWS\n\n<a href=\"https://github.com/cdklabs/cdk-nextjs/graphs/contributors\">\n  <img src=\"https://contrib.rocks/image?repo=cdklabs/cdk-nextjs\" />\n</a>\n"
   },
   "repository": {
     "type": "git",
@@ -4044,83 +4044,123 @@
       ],
       "symbolId": "src/nextjs-file-system:AllowComputeProps"
     },
-    "cdk-nextjs.BaseNextjsConstructOverrides": {
+    "cdk-nextjs.BuilderImageProps": {
       "assembly": "cdk-nextjs",
       "datatype": true,
       "docs": {
-        "stability": "stable",
-        "summary": "Base overrides for the props passed to constructs within root/top-level Next.js constructs."
+        "stability": "stable"
       },
-      "fqn": "cdk-nextjs.BaseNextjsConstructOverrides",
+      "fqn": "cdk-nextjs.BuilderImageProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-base-overrides.ts",
-        "line": 15
+        "filename": "src/nextjs-build/nextjs-build.ts",
+        "line": 29
       },
-      "name": "BaseNextjsConstructOverrides",
+      "name": "BuilderImageProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "Build Args to be passed to `docker build` command."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 19
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 33
           },
-          "name": "nextjsAssetsDeploymentProps",
+          "name": "buildArgs",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsAssetsDeploymentProps"
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "`docker build ...` command to run in {@link NextBaseProps.buildContext }. Default interpolates other props. If you override, other props will have no effect on command."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 16
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 39
           },
-          "name": "nextjsBuildProps",
+          "name": "command",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsBuildProps"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "[\"MY_API_KEY\"]",
+            "remarks": "Note, a shell script, cdk-nextjs-load-env-vars.sh is created within the\n{@link NextBaseProps.buildContext } directory, which will contain all the\nenvironment variables defined in this prop. If you've created your own\ncustom Dockerfile (passed in via {@link BuilderImageProps.customDockerfilePath })\nthen you need to make sure you're copying it into the image.",
+            "stability": "stable",
+            "summary": "Environment variables names to pass from host to container during build process."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 18
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 51
           },
-          "name": "nextjsFileSystemProps",
+          "name": "envVarNames",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsFileSystemProps"
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "[\"node_modules\", \".git\", \".gitignore\", \".md\"]",
+            "stability": "stable",
+            "summary": "Lines in .dockerignore file which will be created in your {@link NextBaseProps.buildContext }."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 20
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 56
           },
-          "name": "nextjsPostDeployProps",
+          "name": "exclude",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsPostDeployProps"
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"builder.Dockerfile\"",
+            "remarks": "If specified, you are responsible\nfor ensuring it exists in build context before construct is instantiated.",
+            "stability": "stable",
+            "summary": "Name of Dockerfile in builder build context."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 62
+          },
+          "name": "file",
+          "optional": true,
+          "type": {
+            "primitive": "string"
           }
         },
         {
@@ -4130,49 +4170,112 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 17
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 63
           },
-          "name": "nextjsVpcProps",
+          "name": "platform",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsVpcProps"
+            "fqn": "aws-cdk-lib.aws_ecr_assets.Platform"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Skip building the builder image."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-build/nextjs-build.ts",
+            "line": 68
+          },
+          "name": "skipBuild",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-base-overrides:BaseNextjsConstructOverrides"
+      "symbolId": "src/nextjs-build/nextjs-build:BuilderImageProps"
     },
-    "cdk-nextjs.BaseNextjsOverrides": {
+    "cdk-nextjs.NextjsApi": {
       "assembly": "cdk-nextjs",
-      "datatype": true,
+      "base": "constructs.Construct",
       "docs": {
         "stability": "stable",
-        "summary": "Base overrides for constructs shared between all root/top-level Next.js constructs."
+        "summary": "Creates an API Gateway REST API for Next.js applications."
       },
-      "fqn": "cdk-nextjs.BaseNextjsOverrides",
-      "kind": "interface",
+      "fqn": "cdk-nextjs.NextjsApi",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/nextjs-api.ts",
+          "line": 74
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsApiProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-base-overrides.ts",
-        "line": 26
+        "filename": "src/nextjs-api.ts",
+        "line": 64
       },
-      "name": "BaseNextjsOverrides",
+      "name": "NextjsApi",
       "properties": [
         {
-          "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "The API Gateway REST API."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 30
+            "filename": "src/nextjs-api.ts",
+            "line": 68
           },
-          "name": "nextjsAssetsDeployment",
-          "optional": true,
+          "name": "api",
           "type": {
-            "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides"
+            "fqn": "aws-cdk-lib.aws_apigateway.RestApi"
           }
-        },
+        }
+      ],
+      "symbolId": "src/nextjs-api:NextjsApi"
+    },
+    "cdk-nextjs.NextjsApiOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdk-nextjs.NextjsApiOverrides",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/nextjs-api.ts",
+        "line": 26
+      },
+      "name": "NextjsApiOverrides",
+      "properties": [
         {
           "abstract": true,
           "docs": {
@@ -4180,13 +4283,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 27
+            "filename": "src/nextjs-api.ts",
+            "line": 30
           },
-          "name": "nextjsBuild",
+          "name": "dynamicIntegrationProps",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsBuildOverrides"
+            "fqn": "aws-cdk-lib.aws_apigateway.LambdaIntegrationOptions"
           }
         },
         {
@@ -4196,13 +4299,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 28
+            "filename": "src/nextjs-api.ts",
+            "line": 27
           },
-          "name": "nextjsFileSystem",
+          "name": "restApiProps",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsFileSystemOverrides"
+            "fqn": "aws-cdk-lib.aws_apigateway.RestApiProps"
           }
         },
         {
@@ -4212,13 +4315,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 31
+            "filename": "src/nextjs-api.ts",
+            "line": 29
           },
-          "name": "nextjsPostDeploy",
+          "name": "s3MethodOptions",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsPostDeployOverrides"
+            "fqn": "aws-cdk-lib.aws_apigateway.MethodOptions"
           }
         },
         {
@@ -4228,51 +4331,50 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-overrides.ts",
-            "line": 29
+            "filename": "src/nextjs-api.ts",
+            "line": 28
           },
-          "name": "nextjsVpc",
+          "name": "staticIntegrationProps",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsVpcOverrides"
+            "fqn": "aws-cdk-lib.aws_apigateway.AwsIntegrationProps"
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-base-overrides:BaseNextjsOverrides"
+      "symbolId": "src/nextjs-api:NextjsApiOverrides"
     },
-    "cdk-nextjs.BuilderImageProps": {
+    "cdk-nextjs.NextjsApiProps": {
       "assembly": "cdk-nextjs",
       "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "cdk-nextjs.BuilderImageProps",
+      "fqn": "cdk-nextjs.NextjsApiProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/nextjs-build/nextjs-build.ts",
-        "line": 29
+        "filename": "src/nextjs-api.ts",
+        "line": 33
       },
-      "name": "BuilderImageProps",
+      "name": "NextjsApiProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Build Args to be passed to `docker build` command."
+            "summary": "Path to directory of Next.js app's public directory. Used to add resources to API Gateway REST API for public directory to go directly to S3."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 33
+            "filename": "src/nextjs-api.ts",
+            "line": 46
           },
-          "name": "buildArgs",
-          "optional": true,
+          "name": "publicDirEntries",
           "type": {
             "collection": {
               "elementtype": {
-                "primitive": "string"
+                "fqn": "cdk-nextjs.PublicDirEntry"
               },
-              "kind": "map"
+              "kind": "array"
             }
           }
         },
@@ -4280,259 +4382,648 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "`docker build ...` command to run in {@link NextBaseProps.buildContext }. Default interpolates other props. If you override, other props will have no effect on command."
+            "summary": "The S3 bucket containing static assets."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 39
+            "filename": "src/nextjs-api.ts",
+            "line": 54
           },
-          "name": "command",
-          "optional": true,
+          "name": "staticAssetsBucket",
           "type": {
-            "primitive": "string"
+            "fqn": "aws-cdk-lib.aws_s3.IBucket"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "example": "[\"MY_API_KEY\"]",
-            "remarks": "Note, a shell script, cdk-nextjs-load-env-vars.sh is created within the\n{@link NextBaseProps.buildContext } directory, which will contain all the\nenvironment variables defined in this prop. If you've created your own\ncustom Dockerfile (passed in via {@link BuilderImageProps.customDockerfilePath })\nthen you need to make sure you're copying it into the image.",
             "stability": "stable",
-            "summary": "Environment variables names to pass from host to container during build process."
+            "summary": "Optional base path for the application."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 51
+            "filename": "src/nextjs-api.ts",
+            "line": 37
           },
-          "name": "envVarNames",
+          "name": "basePath",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "primitive": "string"
-              },
-              "kind": "array"
-            }
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "[\"node_modules\", \".git\", \".gitignore\", \".md\"]",
             "stability": "stable",
-            "summary": "Lines in .dockerignore file which will be created in your {@link NextBaseProps.buildContext }."
+            "summary": "Override props for every construct."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 56
+            "filename": "src/nextjs-api.ts",
+            "line": 41
           },
-          "name": "exclude",
+          "name": "overrides",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "primitive": "string"
-              },
-              "kind": "array"
-            }
+            "fqn": "cdk-nextjs.NextjsApiOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "\"builder.Dockerfile\"",
-            "remarks": "If specified, you are responsible\nfor ensuring it exists in build context before construct is instantiated.",
+            "remarks": "The Lambda function for server-side rendering",
             "stability": "stable",
-            "summary": "Name of Dockerfile in builder build context."
+            "summary": "Required if `NextjsRegionalFunctions`."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 62
+            "filename": "src/nextjs-api.ts",
+            "line": 50
           },
-          "name": "file",
+          "name": "serverFunction",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "remarks": "VPC to create VPC Link and ECS Service Discovery",
+            "stability": "stable",
+            "summary": "[Future] Required if `NextjsRegionalContainers`."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 63
+            "filename": "src/nextjs-api.ts",
+            "line": 58
           },
-          "name": "platform",
+          "name": "vpc",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_ecr_assets.Platform"
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
           }
-        },
+        }
+      ],
+      "symbolId": "src/nextjs-api:NextjsApiProps"
+    },
+    "cdk-nextjs.NextjsAssetDeploymentOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/nextjs-assets-deployment.ts",
+        "line": 27
+      },
+      "name": "NextjsAssetDeploymentOverrides",
+      "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "false",
             "stability": "stable",
-            "summary": "Skip building the builder image."
+            "summary": "Props that define the custom resource."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-build/nextjs-build.ts",
-            "line": 68
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 31
           },
-          "name": "skipBuild",
+          "name": "customResourceProps",
           "optional": true,
           "type": {
-            "primitive": "boolean"
+            "fqn": "cdk-nextjs.OptionalCustomResourceProps"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 34
+          },
+          "name": "dockerImageFunctionProps",
+          "optional": true,
+          "type": {
+            "fqn": "cdk-nextjs.OptionalDockerImageFunctionProps"
           }
         }
       ],
-      "symbolId": "src/nextjs-build/nextjs-build:BuilderImageProps"
+      "symbolId": "src/nextjs-assets-deployment:NextjsAssetDeploymentOverrides"
     },
-    "cdk-nextjs.NextjsAssetDeploymentOverrides": {
+    "cdk-nextjs.NextjsAssetsDeployment": {
+      "assembly": "cdk-nextjs",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "stable",
+        "summary": "Deploys static assets to S3 and cache assets to EFS in Lambda Custom Resource."
+      },
+      "fqn": "cdk-nextjs.NextjsAssetsDeployment",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/nextjs-assets-deployment.ts",
+          "line": 110
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsAssetsDeploymentProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/nextjs-assets-deployment.ts",
+        "line": 104
+      },
+      "name": "NextjsAssetsDeployment",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 105
+          },
+          "name": "customResource",
+          "type": {
+            "fqn": "aws-cdk-lib.CustomResource"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 106
+          },
+          "name": "dockerImageFunction",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.DockerImageFunction"
+          }
+        }
+      ],
+      "symbolId": "src/nextjs-assets-deployment:NextjsAssetsDeployment"
+    },
+    "cdk-nextjs.NextjsAssetsDeploymentProps": {
       "assembly": "cdk-nextjs",
       "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides",
+      "fqn": "cdk-nextjs.NextjsAssetsDeploymentProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/nextjs-assets-deployment.ts",
-        "line": 27
+        "line": 37
       },
-      "name": "NextjsAssetDeploymentOverrides",
+      "name": "NextjsAssetsDeploymentProps",
       "properties": [
         {
-          "abstract": true,
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 38
+          },
+          "name": "accessPoint",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_efs.AccessPoint"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 44
+          },
+          "name": "buildId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "see": "{@link NextjsBuild.buildImageDigest }",
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 48
+          },
+          "name": "buildImageDigest",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 54
+          },
+          "name": "dockerImageCode",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.DockerImageCode"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 55
+          },
+          "name": "nextjsType",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 65
+          },
+          "name": "vpc",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "example": "\"/my-base-path\"",
+            "stability": "stable",
+            "summary": "Prefix to the URI path the app will be served at."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 43
+          },
+          "name": "basePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "If true, logs details in custom resource lambda."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 53
+          },
+          "name": "debug",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 56
+          },
+          "name": "overrides",
+          "optional": true,
+          "type": {
+            "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "see": "{@link NextjsBaseProps.relativePathToPackage }",
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 60
+          },
+          "name": "relativePathToPackage",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Required for `NextjsType.GlobalFunctions` and `NextjsType.GlobalContainers`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-assets-deployment.ts",
+            "line": 64
+          },
+          "name": "staticAssetsBucket",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+          }
+        }
+      ],
+      "symbolId": "src/nextjs-assets-deployment:NextjsAssetsDeploymentProps"
+    },
+    "cdk-nextjs.NextjsBaseConstruct": {
+      "abstract": true,
+      "assembly": "cdk-nextjs",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "stable",
+        "summary": "Base class for all Next.js root constructs."
+      },
+      "fqn": "cdk-nextjs.NextjsBaseConstruct",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/root-constructs/nextjs-base-construct.ts",
+          "line": 152
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsBaseConstructProps"
+            }
+          },
+          {
+            "name": "nextjsType",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsType"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-base-construct.ts",
+        "line": 137
+      },
+      "name": "NextjsBaseConstruct",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 149
+          },
+          "name": "baseProps",
+          "protected": true,
+          "type": {
+            "fqn": "cdk-nextjs.NextjsBaseConstructProps"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 147
+          },
+          "name": "nextjsType",
+          "protected": true,
+          "type": {
+            "fqn": "cdk-nextjs.NextjsType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 145
+          },
+          "name": "url",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 150
+          },
+          "name": "constructOverrides",
+          "optional": true,
+          "protected": true,
+          "type": {
+            "fqn": "cdk-nextjs.NextjsBaseConstructOverrides"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 142
+          },
+          "name": "nextjsAssetsDeployment",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsAssetsDeployment"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 138
+          },
+          "name": "nextjsBuild",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsBuild"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 141
+          },
+          "name": "nextjsFileSystem",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsFileSystem"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 143
+          },
+          "name": "nextjsPostDeploy",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsPostDeploy"
+          }
+        },
+        {
           "docs": {
-            "stability": "stable",
-            "summary": "Props that define the custom resource."
+            "stability": "stable"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 31
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 139
           },
-          "name": "customResourceProps",
-          "optional": true,
+          "name": "nextjsStaticAssets",
           "type": {
-            "fqn": "cdk-nextjs.OptionalCustomResourceProps"
+            "fqn": "cdk-nextjs.NextjsStaticAssets"
           }
         },
         {
-          "abstract": true,
           "docs": {
             "stability": "stable"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 34
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 140
           },
-          "name": "dockerImageFunctionProps",
-          "optional": true,
+          "name": "nextjsVpc",
           "type": {
-            "fqn": "cdk-nextjs.OptionalDockerImageFunctionProps"
+            "fqn": "cdk-nextjs.NextjsVpc"
           }
         }
       ],
-      "symbolId": "src/nextjs-assets-deployment:NextjsAssetDeploymentOverrides"
+      "symbolId": "src/root-constructs/nextjs-base-construct:NextjsBaseConstruct"
     },
-    "cdk-nextjs.NextjsAssetsDeployment": {
+    "cdk-nextjs.NextjsBaseConstructOverrides": {
       "assembly": "cdk-nextjs",
-      "base": "constructs.Construct",
+      "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Deploys static assets to S3 and cache assets to EFS in Lambda Custom Resource."
-      },
-      "fqn": "cdk-nextjs.NextjsAssetsDeployment",
-      "initializer": {
-        "docs": {
-          "stability": "stable"
-        },
-        "locationInModule": {
-          "filename": "src/nextjs-assets-deployment.ts",
-          "line": 110
-        },
-        "parameters": [
-          {
-            "name": "scope",
-            "type": {
-              "fqn": "constructs.Construct"
-            }
-          },
-          {
-            "name": "id",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "name": "props",
-            "type": {
-              "fqn": "cdk-nextjs.NextjsAssetsDeploymentProps"
-            }
-          }
-        ]
+        "summary": "Base overrides for the props passed to constructs within root/top-level Next.js constructs."
       },
-      "kind": "class",
+      "fqn": "cdk-nextjs.NextjsBaseConstructOverrides",
+      "kind": "interface",
       "locationInModule": {
-        "filename": "src/nextjs-assets-deployment.ts",
-        "line": 104
+        "filename": "src/root-constructs/nextjs-base-construct.ts",
+        "line": 35
       },
-      "name": "NextjsAssetsDeployment",
+      "name": "NextjsBaseConstructOverrides",
       "properties": [
         {
+          "abstract": true,
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 105
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 39
           },
-          "name": "customResource",
+          "name": "nextjsAssetsDeploymentProps",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.CustomResource"
+            "fqn": "cdk-nextjs.OptionalNextjsAssetsDeploymentProps"
           }
         },
         {
+          "abstract": true,
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 106
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 36
           },
-          "name": "dockerImageFunction",
+          "name": "nextjsBuildProps",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.DockerImageFunction"
+            "fqn": "cdk-nextjs.OptionalNextjsBuildProps"
           }
-        }
-      ],
-      "symbolId": "src/nextjs-assets-deployment:NextjsAssetsDeployment"
-    },
-    "cdk-nextjs.NextjsAssetsDeploymentProps": {
-      "assembly": "cdk-nextjs",
-      "datatype": true,
-      "docs": {
-        "stability": "stable"
-      },
-      "fqn": "cdk-nextjs.NextjsAssetsDeploymentProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/nextjs-assets-deployment.ts",
-        "line": 37
-      },
-      "name": "NextjsAssetsDeploymentProps",
-      "properties": [
+        },
         {
           "abstract": true,
           "docs": {
@@ -4540,12 +5031,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
             "line": 38
           },
-          "name": "accessPoint",
+          "name": "nextjsFileSystemProps",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_efs.AccessPoint"
+            "fqn": "cdk-nextjs.OptionalNextjsFileSystemProps"
           }
         },
         {
@@ -4555,28 +5047,29 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 44
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 40
           },
-          "name": "buildId",
+          "name": "nextjsPostDeployProps",
+          "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "cdk-nextjs.OptionalNextjsPostDeployProps"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "see": "{@link NextjsBuild.buildImageDigest }",
             "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 48
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 41
           },
-          "name": "buildImageDigest",
+          "name": "nextjsStaticAssetsProps",
+          "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "cdk-nextjs.NextjsStaticAssetsProps"
           }
         },
         {
@@ -4586,14 +5079,36 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 54
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 37
           },
-          "name": "dockerImageCode",
+          "name": "nextjsVpcProps",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.DockerImageCode"
+            "fqn": "cdk-nextjs.OptionalNextjsVpcProps"
           }
-        },
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-base-construct:NextjsBaseConstructOverrides"
+    },
+    "cdk-nextjs.NextjsBaseConstructProps": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Required because if we add `overrides` onto `NextjsBaseProps` we get jsii error: `Interface ... re-declares member \"overrides\"`."
+      },
+      "fqn": "cdk-nextjs.NextjsBaseConstructProps",
+      "interfaces": [
+        "cdk-nextjs.NextjsBaseProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-base-construct.ts",
+        "line": 130
+      },
+      "name": "NextjsBaseConstructProps",
+      "properties": [
         {
           "abstract": true,
           "docs": {
@@ -4601,14 +5116,33 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 55
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 131
           },
-          "name": "nextjsType",
+          "name": "overrides",
+          "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsType"
+            "fqn": "cdk-nextjs.NextjsBaseOverrides"
           }
-        },
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-base-construct:NextjsBaseConstructProps"
+    },
+    "cdk-nextjs.NextjsBaseOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Base overrides for constructs shared between all root/top-level Next.js constructs."
+      },
+      "fqn": "cdk-nextjs.NextjsBaseOverrides",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-base-construct.ts",
+        "line": 47
+      },
+      "name": "NextjsBaseOverrides",
+      "properties": [
         {
           "abstract": true,
           "docs": {
@@ -4616,48 +5150,45 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 65
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 51
           },
-          "name": "vpc",
+          "name": "nextjsAssetsDeployment",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
+            "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "example": "\"/my-base-path\"",
-            "stability": "stable",
-            "summary": "Prefix to the URI path the app will be served at."
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 43
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 48
           },
-          "name": "basePath",
+          "name": "nextjsBuild",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "cdk-nextjs.NextjsBuildOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "true",
-            "stability": "stable",
-            "summary": "If true, logs details in custom resource lambda."
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 53
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 49
           },
-          "name": "debug",
+          "name": "nextjsFileSystem",
           "optional": true,
           "type": {
-            "primitive": "boolean"
+            "fqn": "cdk-nextjs.NextjsFileSystemOverrides"
           }
         },
         {
@@ -4667,51 +5198,49 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 56
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 52
           },
-          "name": "overrides",
+          "name": "nextjsPostDeploy",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsAssetDeploymentOverrides"
+            "fqn": "cdk-nextjs.NextjsPostDeployOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "see": "{@link NextjsBaseProps.relativePathToPackage }",
             "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 60
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 53
           },
-          "name": "relativePathToPackage",
+          "name": "nextjsStaticAssets",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "cdk-nextjs.NextjsStaticAssetsOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "Required for `NextjsType.GlobalFunctions` and `NextjsType.GlobalContainers`."
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-assets-deployment.ts",
-            "line": 64
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 50
           },
-          "name": "staticAssetsBucket",
+          "name": "nextjsVpc",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+            "fqn": "cdk-nextjs.NextjsVpcOverrides"
           }
         }
       ],
-      "symbolId": "src/nextjs-assets-deployment:NextjsAssetsDeploymentProps"
+      "symbolId": "src/root-constructs/nextjs-base-construct:NextjsBaseOverrides"
     },
     "cdk-nextjs.NextjsBaseProps": {
       "assembly": "cdk-nextjs",
@@ -4722,8 +5251,8 @@
       "fqn": "cdk-nextjs.NextjsBaseProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-base-props.ts",
-        "line": 1
+        "filename": "src/root-constructs/nextjs-base-construct.ts",
+        "line": 56
       },
       "name": "NextjsBaseProps",
       "properties": [
@@ -4737,8 +5266,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-props.ts",
-            "line": 22
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 82
           },
           "name": "buildContext",
           "type": {
@@ -4754,14 +5283,32 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-props.ts",
-            "line": 34
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 94
           },
           "name": "healthCheckPath",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "example": "\"/my-base-path\"",
+            "stability": "stable",
+            "summary": "Prefix to the URI path the app will be served at."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 61
+          },
+          "name": "basePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4771,8 +5318,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-props.ts",
-            "line": 6
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 66
           },
           "name": "buildCommand",
           "optional": true,
@@ -4790,8 +5337,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-props.ts",
-            "line": 59
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 119
           },
           "name": "relativePathToPackage",
           "optional": true,
@@ -4807,8 +5354,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-base-props.ts",
-            "line": 63
+            "filename": "src/root-constructs/nextjs-base-construct.ts",
+            "line": 123
           },
           "name": "relativePathToWorkspace",
           "optional": true,
@@ -4817,7 +5364,7 @@
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-base-props:NextjsBaseProps"
+      "symbolId": "src/root-constructs/nextjs-base-construct:NextjsBaseProps"
     },
     "cdk-nextjs.NextjsBuild": {
       "assembly": "cdk-nextjs",
@@ -5867,7 +6414,7 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Path to directory of Next.js app's public directory. Used to add static behaviors to distribution."
+            "summary": "Entries (files/directories) within Next.js app's public directory. Used to add static behaviors to distribution."
           },
           "immutable": true,
           "locationInModule": {
@@ -6191,7 +6738,7 @@
         },
         "locationInModule": {
           "filename": "src/nextjs-compute/nextjs-functions.ts",
-          "line": 42
+          "line": 44
         },
         "parameters": [
           {
@@ -6217,7 +6764,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/nextjs-compute/nextjs-functions.ts",
-        "line": 36
+        "line": 38
       },
       "name": "NextjsFunctions",
       "properties": [
@@ -6227,7 +6774,7 @@
           },
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 37
+            "line": 39
           },
           "name": "function",
           "type": {
@@ -6240,9 +6787,10 @@
           },
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 38
+            "line": 40
           },
           "name": "functionUrl",
+          "optional": true,
           "type": {
             "fqn": "aws-cdk-lib.aws_lambda.FunctionUrl"
           }
@@ -6260,7 +6808,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/nextjs-compute/nextjs-functions.ts",
-        "line": 22
+        "line": 23
       },
       "name": "NextjsFunctionsOverrides",
       "properties": [
@@ -6272,7 +6820,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 23
+            "line": 24
           },
           "name": "dockerImageFunctionProps",
           "optional": true,
@@ -6288,7 +6836,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 24
+            "line": 25
           },
           "name": "functionUrlProps",
           "optional": true,
@@ -6312,7 +6860,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/nextjs-compute/nextjs-functions.ts",
-        "line": 27
+        "line": 28
       },
       "name": "NextjsFunctionsProps",
       "properties": [
@@ -6324,7 +6872,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 30
+            "line": 31
           },
           "name": "buildId",
           "type": {
@@ -6339,7 +6887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 28
+            "line": 29
           },
           "name": "dockerImageCode",
           "type": {
@@ -6354,7 +6902,22 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/nextjs-compute/nextjs-functions.ts",
-            "line": 29
+            "line": 32
+          },
+          "name": "nextjsType",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-compute/nextjs-functions.ts",
+            "line": 30
           },
           "name": "overrides",
           "optional": true,
@@ -6367,7 +6930,7 @@
     },
     "cdk-nextjs.NextjsGlobalContainers": {
       "assembly": "cdk-nextjs",
-      "base": "constructs.Construct",
+      "base": "cdk-nextjs.NextjsBaseConstruct",
       "docs": {
         "stability": "stable",
         "summary": "Deploy Next.js globally distributed with containers. Uses [CloudFront Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) as Content Delivery Network (CDN) for global distribution and [AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) for containers."
@@ -6379,7 +6942,7 @@
         },
         "locationInModule": {
           "filename": "src/root-constructs/nextjs-global-containers.ts",
-          "line": 87
+          "line": 65
         },
         "parameters": [
           {
@@ -6405,7 +6968,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 74
+        "line": 56
       },
       "name": "NextjsGlobalContainers",
       "properties": [
@@ -6413,26 +6976,15 @@
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 79
-          },
-          "name": "nextjsAssetsDeployment",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsAssetsDeployment"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 75
+            "line": 59
           },
-          "name": "nextjsBuild",
+          "name": "url",
+          "overrides": "cdk-nextjs.NextjsBaseConstruct",
           "type": {
-            "fqn": "cdk-nextjs.NextjsBuild"
+            "primitive": "string"
           }
         },
         {
@@ -6441,7 +6993,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 80
+            "line": 57
           },
           "name": "nextjsContainers",
           "type": {
@@ -6454,64 +7006,12 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 81
+            "line": 58
           },
           "name": "nextjsDistribution",
           "type": {
             "fqn": "cdk-nextjs.NextjsDistribution"
           }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 78
-          },
-          "name": "nextjsFileSystem",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsFileSystem"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 82
-          },
-          "name": "nextjsPostDeploy",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsPostDeploy"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 76
-          },
-          "name": "nextjsStaticAssets",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssets"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 77
-          },
-          "name": "nextjsVpc",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsVpc"
-          }
         }
       ],
       "symbolId": "src/root-constructs/nextjs-global-containers:NextjsGlobalContainers"
@@ -6524,12 +7024,12 @@
       },
       "fqn": "cdk-nextjs.NextjsGlobalContainersConstructOverrides",
       "interfaces": [
-        "cdk-nextjs.BaseNextjsConstructOverrides"
+        "cdk-nextjs.NextjsBaseConstructOverrides"
       ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 31
+        "line": 21
       },
       "name": "NextjsGlobalContainersConstructOverrides",
       "properties": [
@@ -6541,7 +7041,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 33
+            "line": 23
           },
           "name": "nextjsContainersProps",
           "optional": true,
@@ -6557,29 +7057,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 34
+            "line": 24
           },
           "name": "nextjsDistributionProps",
           "optional": true,
           "type": {
             "fqn": "cdk-nextjs.OptionalNextjsDistributionProps"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 35
-          },
-          "name": "nextjsStaticAssetsProps",
-          "optional": true,
-          "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssetsProps"
-          }
         }
       ],
       "symbolId": "src/root-constructs/nextjs-global-containers:NextjsGlobalContainersConstructOverrides"
@@ -6594,12 +7078,12 @@
       },
       "fqn": "cdk-nextjs.NextjsGlobalContainersOverrides",
       "interfaces": [
-        "cdk-nextjs.BaseNextjsOverrides"
+        "cdk-nextjs.NextjsBaseOverrides"
       ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 43
+        "line": 32
       },
       "name": "NextjsGlobalContainersOverrides",
       "properties": [
@@ -6611,7 +7095,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 45
+            "line": 34
           },
           "name": "nextjsContainers",
           "optional": true,
@@ -6627,7 +7111,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 46
+            "line": 35
           },
           "name": "nextjsDistribution",
           "optional": true,
@@ -6643,29 +7127,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 44
+            "line": 33
           },
           "name": "nextjsGlobalContainers",
           "optional": true,
           "type": {
             "fqn": "cdk-nextjs.NextjsGlobalContainersConstructOverrides"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 47
-          },
-          "name": "nextjsStaticAssets",
-          "optional": true,
-          "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssetsOverrides"
-          }
         }
       ],
       "symbolId": "src/root-constructs/nextjs-global-containers:NextjsGlobalContainersOverrides"
@@ -6683,29 +7151,10 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 50
+        "line": 38
       },
       "name": "NextjsGlobalContainersProps",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "example": "\"/my-base-path\"",
-            "remarks": "Especially useful when\npassing in your own `distribution`.",
-            "stability": "stable",
-            "summary": "Prefix to the URI path the app will be served at."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 56
-          },
-          "name": "basePath",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -6716,7 +7165,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 61
+            "line": 43
           },
           "name": "distribution",
           "optional": true,
@@ -6733,7 +7182,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 65
+            "line": 47
           },
           "name": "overrides",
           "optional": true,
@@ -6746,7 +7195,7 @@
     },
     "cdk-nextjs.NextjsGlobalFunctions": {
       "assembly": "cdk-nextjs",
-      "base": "constructs.Construct",
+      "base": "cdk-nextjs.NextjsBaseConstruct",
       "docs": {
         "stability": "stable",
         "summary": "Deploy Next.js globally distributed with functions. Uses [CloudFront Distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) as Content Delivery Network (CDN) for global distribution and [AWS Lambda Functions](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) for functions."
@@ -6758,7 +7207,7 @@
         },
         "locationInModule": {
           "filename": "src/root-constructs/nextjs-global-functions.ts",
-          "line": 87
+          "line": 65
         },
         "parameters": [
           {
@@ -6767,103 +7216,40 @@
               "fqn": "constructs.Construct"
             }
           },
-          {
-            "name": "id",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "name": "props",
-            "type": {
-              "fqn": "cdk-nextjs.NextjsGlobalFunctionsProps"
-            }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 74
-      },
-      "name": "NextjsGlobalFunctions",
-      "properties": [
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 79
-          },
-          "name": "nextjsAssetsDeployment",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsAssetsDeployment"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 75
-          },
-          "name": "nextjsBuild",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsBuild"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 81
-          },
-          "name": "nextjsDistribution",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsDistribution"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 78
-          },
-          "name": "nextjsFileSystem",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsFileSystem"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 80
-          },
-          "name": "nextjsFunctions",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsFunctions"
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsGlobalFunctionsProps"
+            }
           }
-        },
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-global-functions.ts",
+        "line": 56
+      },
+      "name": "NextjsGlobalFunctions",
+      "properties": [
         {
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 82
+            "line": 59
           },
-          "name": "nextjsPostDeploy",
+          "name": "url",
+          "overrides": "cdk-nextjs.NextjsBaseConstruct",
           "type": {
-            "fqn": "cdk-nextjs.NextjsPostDeploy"
+            "primitive": "string"
           }
         },
         {
@@ -6872,11 +7258,11 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 76
+            "line": 58
           },
-          "name": "nextjsStaticAssets",
+          "name": "nextjsDistribution",
           "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssets"
+            "fqn": "cdk-nextjs.NextjsDistribution"
           }
         },
         {
@@ -6885,11 +7271,11 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 77
+            "line": 57
           },
-          "name": "nextjsVpc",
+          "name": "nextjsFunctions",
           "type": {
-            "fqn": "cdk-nextjs.NextjsVpc"
+            "fqn": "cdk-nextjs.NextjsFunctions"
           }
         }
       ],
@@ -6903,12 +7289,12 @@
       },
       "fqn": "cdk-nextjs.NextjsGlobalFunctionsConstructOverrides",
       "interfaces": [
-        "cdk-nextjs.BaseNextjsConstructOverrides"
+        "cdk-nextjs.NextjsBaseConstructOverrides"
       ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 31
+        "line": 21
       },
       "name": "NextjsGlobalFunctionsConstructOverrides",
       "properties": [
@@ -6920,7 +7306,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 34
+            "line": 24
           },
           "name": "nextjsDistributionProps",
           "optional": true,
@@ -6936,29 +7322,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 33
+            "line": 23
           },
           "name": "nextjsFunctionsProps",
           "optional": true,
           "type": {
             "fqn": "cdk-nextjs.NextjsFunctionsProps"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 35
-          },
-          "name": "nextjsStaticAssetsProps",
-          "optional": true,
-          "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssetsProps"
-          }
         }
       ],
       "symbolId": "src/root-constructs/nextjs-global-functions:NextjsGlobalFunctionsConstructOverrides"
@@ -6973,12 +7343,12 @@
       },
       "fqn": "cdk-nextjs.NextjsGlobalFunctionsOverrides",
       "interfaces": [
-        "cdk-nextjs.BaseNextjsOverrides"
+        "cdk-nextjs.NextjsBaseOverrides"
       ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 43
+        "line": 32
       },
       "name": "NextjsGlobalFunctionsOverrides",
       "properties": [
@@ -6990,7 +7360,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 46
+            "line": 35
           },
           "name": "nextjsDistribution",
           "optional": true,
@@ -7006,7 +7376,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 45
+            "line": 34
           },
           "name": "nextjsFunctions",
           "optional": true,
@@ -7022,29 +7392,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 44
+            "line": 33
           },
           "name": "nextjsGlobalFunctions",
           "optional": true,
           "type": {
             "fqn": "cdk-nextjs.NextjsGlobalFunctionsConstructOverrides"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 47
-          },
-          "name": "nextjsStaticAssets",
-          "optional": true,
-          "type": {
-            "fqn": "cdk-nextjs.NextjsStaticAssetsOverrides"
-          }
         }
       ],
       "symbolId": "src/root-constructs/nextjs-global-functions:NextjsGlobalFunctionsOverrides"
@@ -7062,29 +7416,10 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 50
+        "line": 38
       },
       "name": "NextjsGlobalFunctionsProps",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "example": "\"/my-base-path\"",
-            "remarks": "Especially useful when\npassing in your own `distribution`.",
-            "stability": "stable",
-            "summary": "Prefix to the URI path the app will be served at."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 56
-          },
-          "name": "basePath",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -7095,7 +7430,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 61
+            "line": 43
           },
           "name": "distribution",
           "optional": true,
@@ -7112,7 +7447,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 65
+            "line": 47
           },
           "name": "overrides",
           "optional": true,
@@ -7360,89 +7695,291 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "CloudFront Distribution to invalidate."
+            "stability": "stable",
+            "summary": "CloudFront Distribution to invalidate."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-post-deploy.ts",
+            "line": 48
+          },
+          "name": "distribution",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_cloudfront.IDistribution"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Override props for every construct."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-post-deploy.ts",
+            "line": 52
+          },
+          "name": "overrides",
+          "optional": true,
+          "type": {
+            "fqn": "cdk-nextjs.NextjsPostDeployOverrides"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "see": "{@link NextjsBaseProps.relativePathToPackage }",
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-post-deploy.ts",
+            "line": 56
+          },
+          "name": "relativePathToPackage",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Required for `NextjsType.GlobalFunctions` and `NextjsType.GlobalContainers`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/nextjs-post-deploy.ts",
+            "line": 60
+          },
+          "name": "staticAssetsBucket",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+          }
+        }
+      ],
+      "symbolId": "src/nextjs-post-deploy:NextjsPostDeployProps"
+    },
+    "cdk-nextjs.NextjsRegionalContainers": {
+      "assembly": "cdk-nextjs",
+      "base": "cdk-nextjs.NextjsBaseConstruct",
+      "docs": {
+        "stability": "stable",
+        "summary": "Deploy Next.js load balanced with containers. Uses [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html) for load balancing and [AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) for containers."
+      },
+      "fqn": "cdk-nextjs.NextjsRegionalContainers",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/root-constructs/nextjs-regional-containers.ts",
+          "line": 53
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "cdk-nextjs.NextjsRegionalContainersProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-regional-containers.ts",
+        "line": 43
+      },
+      "name": "NextjsRegionalContainers",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 45
+          },
+          "name": "url",
+          "overrides": "cdk-nextjs.NextjsBaseConstruct",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 44
+          },
+          "name": "nextjsContainers",
+          "type": {
+            "fqn": "cdk-nextjs.NextjsContainers"
+          }
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainers"
+    },
+    "cdk-nextjs.NextjsRegionalContainersConstructOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdk-nextjs.NextjsRegionalContainersConstructOverrides",
+      "interfaces": [
+        "cdk-nextjs.NextjsBaseConstructOverrides"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-regional-containers.ts",
+        "line": 15
+      },
+      "name": "NextjsRegionalContainersConstructOverrides",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-post-deploy.ts",
-            "line": 48
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 17
           },
-          "name": "distribution",
+          "name": "nextjsContainerProps",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_cloudfront.IDistribution"
+            "fqn": "cdk-nextjs.OptionalNextjsContainersProps"
           }
-        },
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersConstructOverrides"
+    },
+    "cdk-nextjs.NextjsRegionalContainersOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "remarks": "Overrides are lower level than\nprops and are passed directly to CDK Constructs giving you more control. It's\nrecommended to use caution and review source code so you know how they're used.",
+        "stability": "stable",
+        "summary": "Overrides for `NextjsRegionalContainers`."
+      },
+      "fqn": "cdk-nextjs.NextjsRegionalContainersOverrides",
+      "interfaces": [
+        "cdk-nextjs.NextjsBaseOverrides"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-regional-containers.ts",
+        "line": 25
+      },
+      "name": "NextjsRegionalContainersOverrides",
+      "properties": [
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "Override props for every construct."
+            "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-post-deploy.ts",
-            "line": 52
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 27
           },
-          "name": "overrides",
+          "name": "nextjsContainers",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsPostDeployOverrides"
+            "fqn": "cdk-nextjs.NextjsContainersOverrides"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "see": "{@link NextjsBaseProps.relativePathToPackage }",
             "stability": "stable"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-post-deploy.ts",
-            "line": 56
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 26
           },
-          "name": "relativePathToPackage",
+          "name": "nextjsRegionalContainers",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "cdk-nextjs.NextjsRegionalContainersConstructOverrides"
           }
-        },
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersOverrides"
+    },
+    "cdk-nextjs.NextjsRegionalContainersProps": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdk-nextjs.NextjsRegionalContainersProps",
+      "interfaces": [
+        "cdk-nextjs.NextjsBaseProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-regional-containers.ts",
+        "line": 30
+      },
+      "name": "NextjsRegionalContainersProps",
+      "properties": [
         {
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Required for `NextjsType.GlobalFunctions` and `NextjsType.GlobalContainers`."
+            "summary": "Override props of any construct."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/nextjs-post-deploy.ts",
-            "line": 60
+            "filename": "src/root-constructs/nextjs-regional-containers.ts",
+            "line": 34
           },
-          "name": "staticAssetsBucket",
+          "name": "overrides",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+            "fqn": "cdk-nextjs.NextjsRegionalContainersOverrides"
           }
         }
       ],
-      "symbolId": "src/nextjs-post-deploy:NextjsPostDeployProps"
+      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersProps"
     },
-    "cdk-nextjs.NextjsRegionalContainers": {
+    "cdk-nextjs.NextjsRegionalFunctions": {
       "assembly": "cdk-nextjs",
-      "base": "constructs.Construct",
+      "base": "cdk-nextjs.NextjsBaseConstruct",
       "docs": {
         "stability": "stable",
-        "summary": "Deploy Next.js load balanced with containers. Uses [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html) for load balancing and [AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html) for containers."
+        "summary": "Deploy Next.js regionally with functions. Uses API Gateway REST API for routing requests and AWS Lambda Functions for server-side rendering."
       },
-      "fqn": "cdk-nextjs.NextjsRegionalContainers",
+      "fqn": "cdk-nextjs.NextjsRegionalFunctions",
       "initializer": {
         "docs": {
           "stability": "stable"
         },
         "locationInModule": {
-          "filename": "src/root-constructs/nextjs-regional-containers.ts",
-          "line": 59
+          "filename": "src/root-constructs/nextjs-regional-functions.ts",
+          "line": 54
         },
         "parameters": [
           {
@@ -7460,42 +7997,31 @@
           {
             "name": "props",
             "type": {
-              "fqn": "cdk-nextjs.NextjsRegionalContainersProps"
+              "fqn": "cdk-nextjs.NextjsRegionalFunctionsProps"
             }
           }
         ]
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-regional-containers.ts",
-        "line": 48
+        "filename": "src/root-constructs/nextjs-regional-functions.ts",
+        "line": 45
       },
-      "name": "NextjsRegionalContainers",
+      "name": "NextjsRegionalFunctions",
       "properties": [
         {
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 52
-          },
-          "name": "nextjsAssetsDeployment",
-          "type": {
-            "fqn": "cdk-nextjs.NextjsAssetsDeployment"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 49
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 48
           },
-          "name": "nextjsBuild",
+          "name": "url",
+          "overrides": "cdk-nextjs.NextjsBaseConstruct",
           "type": {
-            "fqn": "cdk-nextjs.NextjsBuild"
+            "primitive": "string"
           }
         },
         {
@@ -7503,12 +8029,12 @@
             "stability": "stable"
           },
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 53
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 47
           },
-          "name": "nextjsContainers",
+          "name": "nextjsApi",
           "type": {
-            "fqn": "cdk-nextjs.NextjsContainers"
+            "fqn": "cdk-nextjs.NextjsApi"
           }
         },
         {
@@ -7516,59 +8042,87 @@
             "stability": "stable"
           },
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 51
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 46
           },
-          "name": "nextjsFileSystem",
+          "name": "nextjsFunctions",
           "type": {
-            "fqn": "cdk-nextjs.NextjsFileSystem"
+            "fqn": "cdk-nextjs.NextjsFunctions"
           }
-        },
+        }
+      ],
+      "symbolId": "src/root-constructs/nextjs-regional-functions:NextjsRegionalFunctions"
+    },
+    "cdk-nextjs.NextjsRegionalFunctionsConstructOverrides": {
+      "assembly": "cdk-nextjs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "cdk-nextjs.NextjsRegionalFunctionsConstructOverrides",
+      "interfaces": [
+        "cdk-nextjs.NextjsBaseConstructOverrides"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/root-constructs/nextjs-regional-functions.ts",
+        "line": 17
+      },
+      "name": "NextjsRegionalFunctionsConstructOverrides",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 54
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 20
           },
-          "name": "nextjsPostDeploy",
+          "name": "nextjsApiProps",
+          "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsPostDeploy"
+            "fqn": "cdk-nextjs.NextjsApiProps"
           }
         },
         {
+          "abstract": true,
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 50
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 19
           },
-          "name": "nextjsVpc",
+          "name": "nextjsFunctionsProps",
+          "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsVpc"
+            "fqn": "cdk-nextjs.NextjsFunctionsProps"
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainers"
+      "symbolId": "src/root-constructs/nextjs-regional-functions:NextjsRegionalFunctionsConstructOverrides"
     },
-    "cdk-nextjs.NextjsRegionalContainersConstructOverrides": {
+    "cdk-nextjs.NextjsRegionalFunctionsOverrides": {
       "assembly": "cdk-nextjs",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "remarks": "Overrides are lower level than\nprops and are passed directly to CDK Constructs giving you more control. It's\nrecommended to use caution and review source code so you know how they're used.",
+        "stability": "stable",
+        "summary": "Overrides for `NextjsRegionalFunctions`."
       },
-      "fqn": "cdk-nextjs.NextjsRegionalContainersConstructOverrides",
+      "fqn": "cdk-nextjs.NextjsRegionalFunctionsOverrides",
       "interfaces": [
-        "cdk-nextjs.BaseNextjsConstructOverrides"
+        "cdk-nextjs.NextjsBaseOverrides"
       ],
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-regional-containers.ts",
-        "line": 20
+        "filename": "src/root-constructs/nextjs-regional-functions.ts",
+        "line": 28
       },
-      "name": "NextjsRegionalContainersConstructOverrides",
+      "name": "NextjsRegionalFunctionsOverrides",
       "properties": [
         {
           "abstract": true,
@@ -7577,37 +8131,15 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 22
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 31
           },
-          "name": "nextjsContainerProps",
+          "name": "nextjsApi",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.OptionalNextjsContainersProps"
+            "fqn": "cdk-nextjs.NextjsApiOverrides"
           }
-        }
-      ],
-      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersConstructOverrides"
-    },
-    "cdk-nextjs.NextjsRegionalContainersOverrides": {
-      "assembly": "cdk-nextjs",
-      "datatype": true,
-      "docs": {
-        "remarks": "Overrides are lower level than\nprops and are passed directly to CDK Constructs giving you more control. It's\nrecommended to use caution and review source code so you know how they're used.",
-        "stability": "stable",
-        "summary": "Overrides for `NextjsRegionalContainers`."
-      },
-      "fqn": "cdk-nextjs.NextjsRegionalContainersOverrides",
-      "interfaces": [
-        "cdk-nextjs.BaseNextjsOverrides"
-      ],
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "src/root-constructs/nextjs-regional-containers.ts",
-        "line": 30
-      },
-      "name": "NextjsRegionalContainersOverrides",
-      "properties": [
+        },
         {
           "abstract": true,
           "docs": {
@@ -7615,13 +8147,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 32
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 30
           },
-          "name": "nextjsContainers",
+          "name": "nextjsFunctions",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsContainersOverrides"
+            "fqn": "cdk-nextjs.NextjsFunctionsOverrides"
           }
         },
         {
@@ -7631,34 +8163,34 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 31
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 29
           },
-          "name": "nextjsRegionalContainers",
+          "name": "nextjsRegionalFunctions",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsRegionalContainersConstructOverrides"
+            "fqn": "cdk-nextjs.NextjsRegionalFunctionsConstructOverrides"
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersOverrides"
+      "symbolId": "src/root-constructs/nextjs-regional-functions:NextjsRegionalFunctionsOverrides"
     },
-    "cdk-nextjs.NextjsRegionalContainersProps": {
+    "cdk-nextjs.NextjsRegionalFunctionsProps": {
       "assembly": "cdk-nextjs",
       "datatype": true,
       "docs": {
         "stability": "stable"
       },
-      "fqn": "cdk-nextjs.NextjsRegionalContainersProps",
+      "fqn": "cdk-nextjs.NextjsRegionalFunctionsProps",
       "interfaces": [
         "cdk-nextjs.NextjsBaseProps"
       ],
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/root-constructs/nextjs-regional-containers.ts",
-        "line": 35
+        "filename": "src/root-constructs/nextjs-regional-functions.ts",
+        "line": 34
       },
-      "name": "NextjsRegionalContainersProps",
+      "name": "NextjsRegionalFunctionsProps",
       "properties": [
         {
           "abstract": true,
@@ -7668,17 +8200,17 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/root-constructs/nextjs-regional-containers.ts",
-            "line": 39
+            "filename": "src/root-constructs/nextjs-regional-functions.ts",
+            "line": 38
           },
           "name": "overrides",
           "optional": true,
           "type": {
-            "fqn": "cdk-nextjs.NextjsRegionalContainersOverrides"
+            "fqn": "cdk-nextjs.NextjsRegionalFunctionsOverrides"
           }
         }
       ],
-      "symbolId": "src/root-constructs/nextjs-regional-containers:NextjsRegionalContainersProps"
+      "symbolId": "src/root-constructs/nextjs-regional-functions:NextjsRegionalFunctionsProps"
     },
     "cdk-nextjs.NextjsStaticAssets": {
       "assembly": "cdk-nextjs",
@@ -7694,7 +8226,7 @@
         },
         "locationInModule": {
           "filename": "src/nextjs-static-assets.ts",
-          "line": 30
+          "line": 26
         },
         "parameters": [
           {
@@ -7720,7 +8252,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/nextjs-static-assets.ts",
-        "line": 25
+        "line": 21
       },
       "name": "NextjsStaticAssets",
       "properties": [
@@ -7730,7 +8262,7 @@
           },
           "locationInModule": {
             "filename": "src/nextjs-static-assets.ts",
-            "line": 26
+            "line": 22
           },
           "name": "bucket",
           "type": {
@@ -7802,23 +8334,6 @@
           "type": {
             "fqn": "cdk-nextjs.NextjsStaticAssetsOverrides"
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Required if `NextjsType.REGIONAL_CONTAINERS`."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/nextjs-static-assets.ts",
-            "line": 19
-          },
-          "name": "vpcId",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
         }
       ],
       "symbolId": "src/nextjs-static-assets:NextjsStaticAssetsProps"
@@ -7852,6 +8367,12 @@
             "stability": "stable"
           },
           "name": "REGIONAL_CONTAINERS"
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "name": "REGIONAL_FUNCTIONS"
         }
       ],
       "name": "NextjsType",
@@ -13190,7 +13711,7 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Path to directory of Next.js app's public directory. Used to add static behaviors to distribution."
+            "summary": "Entries (files/directories) within Next.js app's public directory. Used to add static behaviors to distribution."
           },
           "immutable": true,
           "locationInModule": {
@@ -14399,6 +14920,6 @@
       "symbolId": "src/nextjs-build/nextjs-build:PublicDirEntry"
     }
   },
-  "version": "0.4.2",
-  "fingerprint": "yE73lbdN5N5mIeiO7ipZOFVfjUpSZ2q+34Lq+IzP/48="
+  "version": "0.4.3",
+  "fingerprint": "gZlv5xxphGKy5YHU/LxHXuarJHZXeHzCsHOybf7Ug+U="
 }