boxel

Building the Repository

To build the entire repository and run the application, follow these steps:

1. The 2 main system dependencies to install are:

   • volta
   • docker
   • pnpm Note: If you don’t have pnpm already on your system, DON’T install pnpm manually (volta will install it for you when you call pnpm install).

2. Clone the repo:

   git clone https://github.com/cardstack/boxel.git
   

3. Install the package dependencies:

   echo 'export VOLTA_FEATURE_PNPM=1"' >> ~/.profile && source ~/.profile
   pnpm install
   

4. Build the boxel-ui and boxl-motion addons:

   cd ./packages/boxel-ui/addon
   pnpm rebuild:icons
   pnpm build
   cd ../../boxel-motion/addon
   pnpm build
   

5. Build the host:

   cd ./packages/host
   pnpm start
   

6. Run the realm server:

   cd ./packages/realm-server
   pnpm start:all
   

   Note: Ensure that the realm-server is completely started by looking out for tor the test-realm indexing output.

   Realm http://localhost:4202/test/ has started ({
   "instancesIndexed": 8,
   "instanceErrors": 0,
   "moduleErrors": 0
   })
   

7. Register ALL:

   cd ./packages/matrix
   pnpm register-all
   

8. Verify registration:

   cd ./packages/matrix
   pnpm start:admin
   

   Visit http://localhost:8080. Type in Username = “admin”, Password: “password” Homeserver URL: http://localhost:8008

9. Host App
   • Visit http://localhost:4201/
   • Enter the registration flow and create a Boxel Account
   • When prompted for an authentication token, type in “dev-token”
10. Validate email for login
    • Visit SMTP UI at http://localhost:5001/
    • Validate email
    • Go back to Host and login
11. Validate email for login
    • Visit SMTP UI at http://localhost:5001/
    • Validate email
    • Go back to Host and login

12. Run ai bot (Optional):

    cd ./packages/ai-bot
    OPENAI_API_KEY=*** pnpm start
    

Cleanup command

If you experience issues, you can start from scratch by running this command

pnpm clear-caches
rm -rf ./packages/matrix/synapse-data
docker ps -a --format '' | grep -E 'boxel-smtp|boxel-synapse|synapse-admin' | xargs -r docker stop
docker ps -a --format '' | grep -E 'boxel-smtp|boxel-synapse|synapse-admin' | xargs -r docker rm -v