TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published


GitHub npm version Maven Central NuGet latest version PyPi version Go Reference

The CloudfrontGeoLocator is an AWS CDK construct that automates the setup of a CloudFront distribution with an Origin Request Lambda function, enabling applications to determine the geolocation of their users based on incoming HTTP requests. It's an ideal solution for developers looking to enhance their cloud applications with geolocation awareness without delving into the complexities of AWS configurations.

Table of Contents


To install CloudfrontGeoLocator construct library using npm, run the following command:

npm i cdk-cloudfront-geo-locator


To initialize the CloudfrontGeoLocator construct you can use the following code:

import cdk = require('aws-cdk-lib');
import { Construct } from 'constructs';
import { CloudfrontGeoLocator } from 'cdk-cloudfront-geo-locator';

// stack initialization with default props
const geoLocator = new CloudfrontGeoLocator(this, 'GeoLocator');

// stack initialization with custom props
const geoLocatorWithProps = new CloudfrontGeoLocator(
    s3BucketName: 'cloudfront-origin-bucket-name', // optional
    lambdaFunctionName: 'cloudfront-origin-request-edge-lambda-function-name', // optional
    cloudfrontCachePolicyName: 'cloudfront-cache-policy-name', // optional
    cloudfrontOriginRequestPolicyName: 'cloudfront-origin-request-policy-name', // optional
    cloudfrontPriceClass: cloudfront.PriceClass.PRICE_CLASS_100, // optional

// stack initialization with custom domain
const customDomainGeoLocator = new CloudfrontGeoLocator(
    customDomainName: '',

// exported properties
console.log(geoLocator.s3BucketArn); // The ARN of the S3 bucket.
console.log(geoLocator.lambdaFunctionArn); // The ARN of the Lambda function.
console.log(geoLocator.lambdaFunctionVersion); // The current version of the Lambda function.
console.log(geoLocator.distributionId); // The ID of the CloudFront distribution.
console.log(geoLocator.distributionDomainName); // The domain name of the CloudFront distribution.
console.log(geoLocator.cloudfrontCachePolicyId); // The ID of the CloudFront cache policy.
console.log(geoLocator.cloudfrontOriginRequestPolicyId); // The ID of the CloudFront origin request policy.


To initialize the CloudfrontGeoLocator construct you can use the following props:

 * Properties for the CloudfrontGeoLocator construct.
export interface CloudfrontGeoLocatorProps extends ResourceProps {
   * A unique name to identify the s3 bucket.
   * @default - cloudfront-geo-locator-origin
  readonly s3BucketName?: string;

   * A unique name to identify the lambda function.
   * @default - cloudfront-geo-locator
  readonly lambdaFunctionName?: string;

   * A unique name to identify the cloudfront cache policy.
   * @default - CloudfrontGeoLocatorCachePolicy
  readonly cloudfrontCachePolicyName?: string;

   * A unique name to identify the cloudfront origin request policy.
   * @default - CloudfrontGeoLocatorOriginRequestPolicy
  readonly cloudfrontOriginRequestPolicyName?: string;

   * The price class for the CloudFront distribution.
   * @default - PRICE_CLASS_100
  readonly cloudfrontPriceClass?: cloudfront.PriceClass;

   * The domain name for the CloudFront distribution.
   * @default - undefined
  readonly customDomainName?: string;

   * The ARN of the certificate.
   * @default - undefined
  readonly customDomainCertificateArn?: string;

Geolocation Endpoint Response

The geolocation endpoint returns a JSON object with the following properties:

  "country": "TR",
  "countryName": "Türkiye",
  "countryRegion": "35",
  "countryRegionName": "Izmir",
  "city": "Izmir"


We welcome contributions! Please review code of conduct and contributing guide so that you can understand what actions will and will not be tolerated.

Pull Request Guidelines

  • The main branch is just a snapshot of the latest stable release. All development should be done in development branches. Do not submit PRs against the main branch.
  • Work in the src folder and DO NOT checkin dist in the commits.
  • It's OK to have multiple small commits as you work on the PR
  • If adding a new feature add accompanying test case.
  • If fixing bug,
    • Add accompanying test case if applicable.
    • Provide a detailed description of the bug in the PR.
    • If you are resolving an opened issue add issue number in your PR title.


CloudfrontGeoLocator is MIT licensed.

Package Sidebar


npm i cdk-cloudfront-geo-locator

Weekly Downloads






Unpacked Size

515 kB

Total Files


Last publish


  • ilkrklc