Platform Common Projen

A baseline architecture template for new projects using Projen. This project provides a standardized foundation that includes both frontend and backend components with authentication.

Project Intention

This template serves as a starting point for new projects, providing:

• Consistent project structure and configuration
• Pre-configured development tooling
• Integrated authentication system
• Full-stack application foundation

Components Created

The BatmanProject generates:

Frontend

• React Application - Modern React app with TypeScript
• Clerk Authentication - Integrated user authentication and management

Backend/Infrastructure

• AWS Infrastructure - CDK-based cloud resources
• API Gateway - RESTful API endpoints
• Lambda Functions - Serverless compute
• Database - Persistent data storage

Usage Examples

Basic Project Creation

Create a .projenrc.ts file in your project root:

import { BatmanProject } from '@macedon-technologies/batman';

const project = new BatmanProject({
  name: 'my-new-app',
  defaultReleaseBranch: 'main',
});

project.synth();

Then run:

npx projen

With Custom Configuration

Create a .projenrc.ts file with additional options:

import { BatmanProject } from '@macedon-technologies/batman';

const project = new BatmanProject({
  name: 'my-enterprise-app',
  defaultReleaseBranch: 'main',
  description: 'Enterprise application with authentication',
  authorName: 'Your Name',
  authorEmail: '[email protected]',
});

project.synth();

Then run:

npx projen

Development Workflow

# Install dependencies
yarn install

# Start development server
yarn dev

# Deploy infrastructure
yarn deploy

# Run tests
yarn test