realtimecursor/LOCAL_DEVELOPMENT.md

Real-time collaboration system with cursor tracking and approval workflow

# Local SDK Development

This document provides instructions for local SDK development.

## Building the SDK

### Option 1: Normal Build (with type checking)

```bash
cd sdk
npm run build
```

### Option 2: Development Build (bypassing type checking)

```bash
cd sdk
./build-dev.sh
```

## Running the Application with Local SDK

```bash
./run-with-local-sdk.sh
```

This script will:
1. Build the SDK using the development build script
2. Start the frontend application that uses the local SDK

## Troubleshooting TypeScript Errors

If you encounter TypeScript errors during development:

1. Use the `./build-dev.sh` script to bypass type checking
2. Fix the errors incrementally
3. Once all errors are fixed, switch back to the normal build process

## Common TypeScript Errors and Solutions

1. **Module has no exported member 'X'**
   - Make sure the interface or type is properly exported from the source file
   - Check import statements for correct paths and names

2. **Type 'X' is not assignable to type 'Y'**
   - Add proper type annotations to variables and function parameters
   - Use type assertions when necessary (but sparingly)

3. **Cannot find namespace 'React'**
   - Make sure to import React at the top of your file: `import React from 'react'`

4. **Property 'X' does not exist on type 'Y'**
   - Add the property to the interface definition
   - Use optional properties with `?` when appropriate