A fan-built home for the High Performance Racing Formula 1 leaderboard.
Visit bscorner.com · Get started · Deployment
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.
- 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.
| 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 |
- A current Node.js LTS release
- pnpm
- A Convex project
- A Clerk application when enabling accounts and submissions
pnpm install
cp .env.example .env.local
pnpm devThe 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.
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".
pnpm checkThis runs TypeScript checks, the Vitest suite, and a production build. The same command runs in GitHub Actions for pull requests and pushes to main.
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.
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.
