Skip to content

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Bullshit Corner logo

Bullshit Corner

A fan-built home for the High Performance Racing Formula 1 leaderboard.

Visit bscorner.com · Get started · Deployment

Bullshit Corner social card

Bullshit Corner is where fans can follow the official Bullshit Corner rankings, submit topics for future episodes, and compare their own rankings with the community. It is an independent fan project, not an official High Performance Racing product.

What it does

  • Publishes the official, ranked Formula 1 leaderboard.
  • Lets people create a personal ranking that contributes to a community aggregate.
  • Accepts authenticated topic submissions with optional notes and YouTube links.
  • Supports optional aliases and a persistent anonymous-submission preference.
  • Gives admins a secure review queue to promote or dismiss submissions and manage the leaderboard.

Built with

Area Technology
App React 19, TanStack Start, TanStack Router, Vite, and Nitro SSR
Data Convex and @convex-dev/react-query
Authentication Clerk with Convex JWT authentication
UI Tailwind CSS v4, shadcn/ui, Base UI, and Phosphor Icons
Hosting Vercel

Get started

Prerequisites

Install and run

pnpm install
cp .env.example .env.local
pnpm dev

The app is available at http://localhost:3000. pnpm dev starts Vite and Convex together; use pnpm dev:web or pnpm dev:convex when you need their logs separately.

Configure local environment

Fill in .env.local from .env.example. The client requires VITE_CONVEX_URL; Clerk-enabled environments also need VITE_CLERK_PUBLISHABLE_KEY and the server-only CLERK_SECRET_KEY.

Set VITE_ENABLE_AUTH=true to show account UI and permit authentication. Configure CLERK_JWT_ISSUER_DOMAIN in the corresponding Convex deployment—not in a VITE_ variable.

Important

For Convex authorization to receive Clerk roles, configure the Clerk convex JWT template to include "metadata": "{{user.public_metadata}}". An administrator is a user whose Clerk publicMetadata.role is "admin".

Verify changes

pnpm check

This runs TypeScript checks, the Vitest suite, and a production build. The same command runs in GitHub Actions for pull requests and pushes to main.

Project map

src/        TanStack Start routes, React components, styles, and server helpers
convex/     Schema, queries, mutations, authentication, and moderation logic
shared/     Cross-runtime validation and constants
public/     Favicon, social image, robots.txt, and sitemap.xml
docs/       Historical architecture and product decisions

The public app is rooted at /; authenticated users can visit /submit-topic, /community, /yourSubmissions, and /userSettings. Admin workflows live under /admin and are protected in both the route layer and Convex.

Warning

convex/seed.ts clears every application table before adding sample data. Never run it against a deployment containing real user data.

Deployment

Vercel uses the build command in vercel.json to deploy Convex functions, provide VITE_CONVEX_URL to the build, and initialize synthetic content for preview deployments.

Configure CONVEX_DEPLOY_KEY in Vercel for both Production and Preview deployments. Do not set CONVEX_DEPLOYMENT or VITE_CONVEX_URL as static Vercel environment variables; the deployment command supplies the appropriate URL.

For repository conventions, data-safety guidance, and architecture details, see AGENTS.md.

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages