realtimecursor/test-app/README.md

Real-time collaboration system with cursor tracking and approval workflow

# RealtimeCursor SDK Test App

This is a simple test application to demonstrate the RealtimeCursor SDK.

## Running the Test App

### Option 1: Start the servers separately (recommended)

1. Start the backend server:

```bash
# From the project root
./start-backend.sh
```

2. In another terminal, start the test app server:

```bash
# From the project root
cd test-app
./start-server.sh
```

3. Open http://localhost:8000 in your browser.

### Option 2: Using the test-sdk.sh script

This script will set up the SDK, start both the backend server and the test app server:

```bash
# From the project root
./test-sdk.sh
```

Then open http://localhost:8000 in your browser.

### Option 3: Create a standalone version

You can create a standalone version of the test app that can be distributed:

```bash
# From the project root
cd test-app
./setup-sdk.sh  # First set up the SDK
./create-standalone.sh
```

This will create a `standalone` directory in the test-app folder that contains a self-contained version of the test app.

## Testing Multiple Users

To test the real-time collaboration features:

1. Open the test app in multiple browser windows or tabs
2. Each window will generate a random user with a different color
3. Move your cursor in one window and see it appear in the other windows
4. Type in the editor in one window and see the changes in the other windows

## Features Demonstrated

- Real-time cursor tracking
- Collaborative editing
- User presence indicators
- Typing indicators