A UW Blueprint x BobaTalks project that automates the Flowers tradition — letting students celebrate wins through a Discord bot and displaying approved posts on the BobaTalks website.

This project includes:

• Discord Bot – Collects "Flowers" submissions and handles moderation.
• Web App (Next.js) – Displays approved Flowers on the BobaTalks site.
• Database (Supabase) – Stores submissions and approvals securely.
• CI/CD – Enforces code quality and consistency through GitHub Actions.

git clone https://github.com/uwblueprint/bobatalks-flowers.git
cd bobatalks-flowers

npm ci

cp .env.example .env

Fill in the placeholder values

npm run lint
npm run format -- --check .
npx tsc --noEmit

If these three pass, your setup is perfect ✅.

We use Husky + lint-staged to enforce formatting before commits.

Test it:

git add .
git commit -m "test: check husky hook"

Expected: Prettier and ESLint run automatically before committing.

If hooks don’t run:

npx husky install

Every push and PR triggers GitHub Actions to run:

• ✅ Linting (npm run lint)
• ✅ Formatting check (npm run format -- --check .)
• ✅ TypeScript check (npx tsc --noEmit)

PRs can’t be merged unless these checks pass.

To simulate CI locally:

npm ci
npm run lint
npm run format -- --check .
npx tsc --noEmit

1. Create a new branch:

   git checkout -b feature/your-feature-name

2. Commit using Conventional Commits:

   • feat: → new feature
   • fix: → bug fix
   • chore: → tooling / configs

3. Push and open a PR — CI must pass before merging.

The Discord bot code is located in src/bot/. See src/bot/README.md for detailed bot documentation.

The bot auto-deploys daily at 4 AM Toronto time (9 AM UTC) via GitHub Actions.

1. Add GitHub Secrets (Settings → Secrets and variables → Actions):

• EC2_HOST → Your EC2 IP address
• EC2_SSH_KEY → Your entire .pem file contents

2. Setup EC2 (one-time):

ssh -i your-key.pem ubuntu@your-ec2-ip

# Install Node.js 20 & PM2
sudo apt-get update
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g pm2

# Setup project
mkdir -p ~/bobatalks/logs
cd ~/bobatalks

# Create .env file
nano .env
# Add: DISCORD_TOKEN=... and DISCORD_CLIENT_ID=...

# Enable PM2 on boot
pm2 startup systemd -u ubuntu --hp /home/ubuntu
# Run the sudo command that PM2 prints

3. Deploy:

• Auto: Pushes to main deploy at 4 AM daily
• Manual: GitHub → Actions → "Deploy BobaTalks" → Run workflow

4. Register commands (after first deploy):

ssh -i your-key.pem ubuntu@your-ec2-ip
cd ~/bobatalks
node dist/bot/registerCommands.js
pm2 logs bobatalks

pm2 status              # Check status
pm2 logs bobatalks      # View logs
pm2 restart bobatalks   # Restart
pm2 reload bobatalks    # Zero-downtime reload

💡 Run this one-liner to confirm everything works:

npm run lint && npm run format -- --check . && npx tsc --noEmit

✅ If you see no output — congrats, your setup is perfect!