AI SummarySwimTO Cursor Rules provides workspace configuration, security guidelines, and development standards for the swimTO pool scheduling project running on a Raspberry Pi k3s cluster. Developers working on this project benefit from clear port assignments, OAuth/HTTPS requirements, and project structure documentation.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to add the "swimTO — Cursor Rules" prompt rules to my project. Repository: https://github.com/raolivei/swimTO Please read the repo to find the rules/prompt file, then: 1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type) 2. If there's an existing rules file, merge the new rules in rather than overwriting 3. Confirm what was added
Description
Cursor Rules for swimTO
Project Overview
SwimTO aggregates and displays indoor community pool drop-in swim schedules for Toronto. Commercial/proprietary project. CLUSTER: Deployed on the eldertree Raspberry Pi k3s cluster.
Workspace Configuration
IMPORTANT: This project is part of the raolivei workspace. Workspace-level configuration is managed in the workspace-config repository. • Port Assignments: See ../workspace-config/ports/.env.ports for assigned ports • Web: Port 5173 (Vite default) • API: Port 8000 (assigned to avoid conflicts) • PostgreSQL: Port 5432, Redis: Port 6379 • Workspace Conventions: See ../workspace-config/docs/PROJECT_CONVENTIONS.md • Port Conflict Checker: Run ../workspace-config/scripts/check-ports.sh before starting services • Workspace Scripts: Available in ../workspace-config/scripts/ When starting services locally, always use the assigned ports from workspace-config to prevent conflicts with other projects.
ALWAYS USE HTTPS
• ✅ Production: ALL external-facing services MUST use HTTPS • ✅ OAuth/Authentication: Google OAuth REQUIRES HTTPS (blocks private IPs and HTTP) • ✅ Development: • Use http://localhost:5173 for local desktop testing • Use ngrok/Cloudflare Tunnel for mobile/external testing: https://abc123.ngrok-free.app • ✅ Kubernetes Ingress: All ingress resources MUST use TLS certificates • ❌ NEVER: Use http://192.168.x.x or http://10.x.x.x for OAuth callbacks (Google blocks these) • ❌ NEVER: Expose authentication endpoints over HTTP in production OAuth Redirect URIs: ` ✅ http://localhost:5173/auth/callback (local dev only) ✅ https://swimto.example.com/auth/callback (production) ✅ https://abc123.ngrok-free.app/auth/callback (mobile testing) ❌ http://192.168.2.48:5173/auth/callback (BLOCKED by Google) `
Project Structure
` swimTO/ ├── apps/ │ ├── api/ # FastAPI backend (Python) │ └── web/ # React + Vite frontend (TypeScript) ├── data-pipeline/ # ETL and data discovery (Python) ├── k8s/ # Kubernetes manifests ├── scripts/ # Utility scripts └── docs/ # Documentation `
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster
Works With
Any AI assistant that accepts custom rules or system prompts