@nikovirtala/cdk-codebuild-hosted-github-actions-runner/.kiro/steering/tech.md

A construct to create an AWS CodeBuild project that can be used to run GitHub Actions workflows

# Technology Stack

## Build System

This project uses **Projen** for project configuration and build management. All configuration is defined in `.projenrc.ts`.

- **DO NOT** manually edit generated files (marked with "Generated by projen" comments)
- To modify configuration, edit `.projenrc.ts` and run `npx projen`

## Core Technologies

- **Language**: TypeScript 5.9.3
- **Package Manager**: pnpm (version 10)
- **CDK Version**: AWS CDK 2.221.1
- **JSII**: ~5.9.3 (for multi-language package generation)
- **Code Quality**: Biome (formatting and linting)

## Key Dependencies

- `aws-cdk-lib`: AWS CDK core library
- `constructs`: CDK constructs base library

## Code Style

### Formatting (Biome)

- **Indent**: 4 spaces
- **Line Width**: 120 characters
- **Quote Style**: Double quotes
- **Format on Save**: Enabled in VS Code

### Linting

- Biome linter with recommended rules enabled
- No ESLint (explicitly disabled)
- No Prettier (explicitly disabled)

## Common Commands

```bash
# Build the project
npm run build

# Compile TypeScript
npm run compile

# Run Biome formatter and linter
npm run biome

# Generate API documentation
npm run docgen

# Run tests
npm run test

# Package for distribution
npm run package

# Update dependencies
npm run upgrade

# Regenerate projen configuration
npm run projen
```

## Development Workflow

1. Make changes to source files in `src/`
2. Run `npm run build` to compile and validate
3. Biome will automatically format and lint on save (if using VS Code)
4. For configuration changes, edit `.projenrc.ts` and run `npx projen`