# Unisono Project This project implements a collaborative idea generation and harmonization tool. ## Simple HTTP Auth Feature This feature provides a basic HTTP authentication mechanism for the Single Page Application (SPA). ### Setup 1. **Create a `.env` file in the `backend/` directory**: ```bash cd backend touch .env ``` Add the following line to `backend/.env`, replacing `YOUR_PASSPHRASE_HERE` with your desired secret passphrase: ``` AUTH_PASSPHRASE=YOUR_PASSPHRASE_HERE ``` *Note: If `AUTH_PASSPHRASE` is missing or empty, the application will start without authentication.* 2. **Build and run the application using Docker Compose**: ```bash docker-compose up --build ``` This will build the frontend and backend services and start them. ### Usage 1. **Access the application**: Open your web browser and navigate to `http://localhost:3000`. 2. **Enter the passphrase**: You will be presented with a screen prompting you to enter the passphrase. Enter the passphrase you configured in `backend/.env`. 3. **Access the SPA**: Upon successful authentication, you will gain access to the Single Page Application. Your access will be preserved for the duration of your browser session. ## Deployment The application is designed to be deployed to a custom host. This requires configuring environment variables for the frontend and backend to ensure they can communicate correctly without CORS errors. For detailed instructions on how to configure the application for a custom domain, please see the [Deployment Quickstart Guide](./specs/008-deploy-to-hosting/quickstart.md).