---

How to Run the Project

Prerequisites

• AWS CLI installed and configured (aws configure).
• Node.js and npm installed (for AWS CDK).
• Python 3.9+ installed.
• AWS CDK installed globally: npm install -g aws-cdk.

1. Setup Environment

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Deploy Infrastructure

Run the provided deployment script:

./deploy.sh

Wait for the deployment to finish. It will output the API Gateway Endpoint URL, Cognito User Pool ID, and Client ID.

Example: API Gateway Endpoint URL : https://766rfgtx1b.execute-api.us-east-1.amazonaws.com/prod/ Cognito User Pool ID : us-east-1_9nv5wm5GT Client ID : 1hec9e6q69fmfta89mm1l8o1ds

3. Run the UI (Frontend)

The project now includes a modern React frontend.

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open your browser at http://localhost:5173.

   • Login with: demo-user@example.com / DemoUser123!
   • Enjoy the delicate and attractive interface!

5. If the user is not configured yet, try manually create a new user inside console(under Cognito) To set permanent password via CLI(example): aws cognito-idp admin-set-user-password
   --user-pool-id us-east-1_9nv5wm5GT
   --username demo-user@example.com
   --password DemoUser123!
   --permanent
   --region us-east-1

4. Run the CLI Script (Optional)

You can still use the python script to test the backend directly:

1. Configure client.py:

   API_ENDPOINT = "https://xyz.execute-api.us-east-1.amazonaws.com/prod"
   COGNITO_CLIENT_ID = "..."

2. Run:

   python client.py

5. Test Other Features

• Sharing: Use the API or Postman to call POST /share with { "file_path": "test_upload.txt" }.
• Search: Call GET /search?q=test.