# {{projectName}}

A serverless web application powered by [Runtime Web](https://runtimeweb.com/docs).

## Getting Started

### Prerequisites

- Node.js >= 18.0.0
- AWS CLI configured with credentials
- Yarn or npm

### Installation

Install dependencies:

```bash
npm install
# or
yarn install
```

### Development

Start the local development server:

```bash
npm run dev
# or
yarn dev
```

The application will be available at `http://localhost:3000`.

### Building

Build all targets (React, Lambda, CDK):

```bash
npm run build
# or
yarn build
```

### Deployment

Deploy to AWS:

```bash
# Deploy to dev stage (default)
npm run deploy:dev

# Deploy to staging
npm run deploy:staging

# Deploy to production
npm run deploy:prod
```

### Environment Diagnostics

Check your development environment and project configuration:

```bash
npm run doctor
# or
yarn doctor
```

### Project Information

Display version and configuration information:

```bash
npm run info
# or
yarn info
```

## Project Structure

```
.
├── src/
│   ├── index.tsx                # Application entry point
│   ├── App.tsx                  # Root component
│   ├── routes.tsx               # Route configuration
│   ├── pages/                   # Page components
│   │   ├── HomePage.tsx
│   │   └── AboutPage.tsx
│   │   └── UsersPage.tsx
│   ├── handlers/                # Lambda function handlers
│   │   └── example.handlers.ts
│   └── ties/                    # Ties configuration
│       └── example.ties.ts      # Ties registry
├── public/
│   └── index.html               # HTML template
├── runtime.config.ts            # Runtime framework configuration
├── tsconfig.json                # TypeScript configuration
└── package.json                 # Project dependencies

```

## Configuration

Edit `runtime.config.ts` to customize:

- Project name
- Deployment stages (dev, staging, prod)
- AWS regions and profiles
- Custom domains
- Feature flags (SEO, manifest, warmup)

## Learn More

- [Runtime Web Documentation](https://runtimeweb.com/docs)
- [React Router v7](https://reactrouter.com/)
- [AWS Lambda](https://aws.amazon.com/lambda/)
- [AWS CDK](https://aws.amazon.com/cdk/)

## License

Elastic License 2.0
