Configuration

Learn how to configure your tsc.run application for different environments and cloud providers.

Configuration file

tsc.run uses a configuration file to define your application settings. Create a tsc-run.config.ts or tsc-run.config.js file in your project root.

Basic configuration

// tsc-run.config.ts
export default {
  provider: 'aws' as const,
  region: 'us-east-1',
};

Configuration options

OptionTypeDescription
provider'aws'Cloud provider (currently AWS only)
regionstringAWS region for deployment
eventsobjectEvent configuration for subscribers
resourcesobjectCloud resources like databases

Event configuration

Configure event handling and subscribers:

export default {
    provider: 'aws',
    region: 'us-east-1',
    events: {
        eventBus: 'default',
        subscribers: {
            'send-welcome-email': {
                events: ['user.registered', 'user.verified']
            },
            'increment-registered-users': {
                events: ['user.registered']
            },
            'update-analytics': {
                events: ['user.registered', 'order.completed']
            }
        }
    }
};

Event configuration options

OptionTypeDescription
eventBusstringAWS EventBridge bus name
subscribersobjectMap of subscriber names to their configuration
subscribers[name].eventsstring[]Array of event names this subscriber handles

Next steps