Create a GitHub Personal Access Token

Follow these steps to create a GitHub personal access token for AWS Amplify deployment:

1. Log in to GitHub: Go to github.com and sign in to your account.

2. Access Developer Settings:

   • Click on your profile photo in the top-right corner
   • Select "Settings" from the dropdown menu
   • Scroll down and click on "Developer settings" in the left sidebar
   • Click on "Personal access tokens" → "Tokens (classic)"

3. Generate a New Token:

   • Click "Generate new token" → "Generate new token (classic)"
   • Note: You may need to confirm your password

4. Configure Token Settings:

   • Token name: Enter a descriptive name (e.g., "AI SaaS Amplify Deployment")
   • Expiration: Choose an appropriate expiration (30 days, 60 days, or custom)
   • Scopes: Select the following permissions:
     • ✓ repo (Full control of private repositories)
     • ✓ admin:repo_hook (Full control of repository hooks)

5. Create Token:

   • Scroll to the bottom and click "Generate token"

6. Copy Your Token:

   • IMPORTANT: Copy the generated token immediately
   • GitHub will only show this token once
   • Store it securely for use in your .env file

Access Your Pre-Created Repository

After purchasing the AI SaaS Boilerplate, a private repository will be automatically created for you under the deployframe-official organization with a unique identifier.

1. Check your email for a GitHub repository invitation
2. The repository will be named: deployframe-official/deployframe-boilerplate-XXXXXXXXX (where XXXXXXXXX is your unique identifier)
3. Click the invitation link in your email to accept access to the repository
4. You will have admin access to this repository

Clone Your Repository

Clone the repository that was created for you to your local machine:

git clone https://github.com/deployframe-official/deployframe-boilerplate-XXXXXXXXX.git
cd deployframe-boilerplate-XXXXXXXXX

Set Up Project Environment Variables

Set up environment variables for project paths that will be used throughout the deployment process:

# Set project root path
export PROJECT_ROOT=$(pwd)
export CDK_DIR=${PROJECT_ROOT}/cdk
 
echo "Project root: $PROJECT_ROOT"
echo "CDK directory: $CDK_DIR"

Create and Set Up the Development Branch

The repository initially contains only the main branch. Create a dev branch for development deployment:

git checkout -b dev
git push -u origin dev

This creates a new dev branch locally, switches to it, and pushes it to the remote repository with upstream tracking. By default, the deployment will target the dev branch since the default configuration uses stage=dev.

Navigate to the CDK Directory

The repository has a monorepo structure with separate folders for frontend, backend, and infrastructure (CDK). Navigate to the CDK directory where we'll configure the deployment:

cd cdk

Create Environment Variables File

Create a file named .env in your project's cdk directory:

# Application Configuration
APP_NAME=ai-saas
 
# Environment Stage
STAGE=dev
 
# AWS Configuration
AWS_DEFAULT_REGION=eu-west-2
AWS_ACCOUNT_ID=123456789012
 
# Domain Configuration (Leave empty for initial deployment)
DOMAIN_NAME=
 
# GitHub Configuration (Required for Amplify Deployment)
GITHUB_OWNER=deployframe-official
GITHUB_REPO=deployframe-boilerplate-XXXXXXXXX
GITHUB_TOKEN=your-github-personal-access-token
GITHUB_DEV_BRANCH=dev
GITHUB_PROD_BRANCH=main
 
# Stripe Integration (Placeholders for now)
STRIPE_API_PUBLIC_KEY=pk_test_placeholder
STRIPE_API_SECRET_KEY=sk_test_placeholder
STRIPE_WEBHOOK_SECRET_KEY=whsec_placeholder
 
# Google OAuth (Placeholders for now)
GOOGLE_OAUTH_CLIENT_ID=placeholder.apps.googleusercontent.com
GOOGLE_OAUTH_CLIENT_SECRET=placeholder_secret
 
# Google Analytics
GOOGLE_ANALYTICS_ID=G-PLACEHOLDER
 
# OpenAI API (Leave empty for initial deployment)
OPENAI_API_KEY=
 
# AWS Bedrock Configuration
AWS_BEDROCK_REGION=us-east-1
 
# Youtube API (Leave empty for initial deployment)
YOUTUBE_API_KEY=