Intern Project 2025: Soundboard Extension + Web App

Structure

• api/ - Rails API backend
• extension/ - Chrome extension (injects + plays sounds)
• ui/ - React TypeScript frontend for Website

Development

Prerequisites

• Ruby 3.4.4 (asdf)
• Node.js
• PostgreSQL

Set up

cd api && bundle install
cd ui && pnpm install
cd extension && pnpm install

Environment Variables

• There should be environment variables at the top of each repository (api/.env, ui/.env, and extension/.env)
• There are .env.example files in each of the directories to copy. For api/.env, contents are in 1Password.

Database

cd api
bundle exec rails db:create db:migrate db:seed

Run servers

cd api && bundle exec rails server
cd ui && pnpm run dev
cd extension && pnpm run dev

Load extension

• Go to chrome://extensions/
• Enable developer mode in the top right
• Click Load unpacked in the top left
• Choose the folder that pnpm run dev told you to (likely .output/chrome-mv3-dev)

Build extension (production)

• Run pnpm run build -- --mode production
• This creates the extension with the .env.production variables - connecting it to the production website and api.
• Load unpacked or upload to Chrome Web Store (folder is likely .output/chrome-mv3)

Environments

Staging: https://staging.parakeet.vigetx.com

Production: https://parakeet.vigetx.com

Server

Direct server access is available over SSH:

Connect to the server (requires your SSH public key to be on the server)

ssh [email protected]