feat: full-stack Roblox ranking dashboard with PostgreSQL

- Next.js 16, React 19, TypeScript, TailwindCSS v4, shadcn/ui
- Prisma with PostgreSQL, Better Auth for session management
- Roblox Open Cloud API integration (no cookies/noblox.js)
- Dark/Light/AMOLED themes with accent color picker
- BigInt support for Roblox IDs (overflow-safe)
- AES-256-GCM encryption for API keys
- Docker + CI/CD setup
- Auth: username + password, synthetic email pattern
- Group/member management, promotions, demotions, rank requests
- Audit logging, settings, dashboard with live stats

Author: vortexsinclair

.dockerignore

@@ -0,0 +1,8 @@
+.dockerignore
+node_modules
+.next
+.git
+.env*
+*.md
+LICENSE
+docker-compose.yml

.env.example

@@ -0,0 +1,20 @@
+# Database
+DATABASE_URL="file:./dev.db"
+
+# Auth
+AUTH_SECRET="generate-a-random-secret-here"
+
+# GitHub OAuth
+GITHUB_CLIENT_ID=""
+GITHUB_CLIENT_SECRET=""
+
+# Discord OAuth
+DISCORD_CLIENT_ID=""
+DISCORD_CLIENT_SECRET=""
+
+# Encryption key for API keys (32 bytes hex)
+ENCRYPTION_KEY=""
+
+# App
+NEXT_PUBLIC_APP_NAME="Infinity Ranking"
+NEXT_PUBLIC_APP_URL="http://localhost:3000"

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npx prisma generate
+      - run: npx tsc --noEmit
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npx prisma generate
+      - run: npm run build

.gitignore

@@ -1,5 +1,3 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
 # dependencies
 /node_modules
 /.pnp
@@ -30,12 +28,28 @@ yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
-# env files (can opt-in for committing if needed)
+# env files
 .env*
+!.env.example
 
 # vercel
 .vercel
 
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+
+# prisma
+prisma/dev.db
+prisma/dev.db-journal
+dev.db
+dev.db-journal
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# os
+Thumbs.db

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "singleQuote": false,
+  "semi": true,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "printWidth": 100
+}

CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# Contributing to Infinity Ranking
+
+Thank you for your interest in contributing! Here are some guidelines to help you get started.
+
+## Development Setup
+
+1. Fork the repository
+2. Clone your fork
+3. Install dependencies: `npm install`
+4. Copy `.env.example` to `.env.local` and configure
+5. Run `npx prisma db push` to set up the database
+6. Start the dev server: `npm run dev`
+
+## Code Standards
+
+- **TypeScript**: All code must be strongly typed. No `any` types.
+- **Linting**: Run `npm run lint` before committing
+- **Components**: Use shadcn/ui primitives when possible
+- **Styling**: Use TailwindCSS utility classes
+- **State**: Use Zustand for global state, TanStack Query for server state
+- **Validation**: Use Zod for all input validation
+- **Testing**: Write tests for new features when applicable
+
+## Pull Request Process
+
+1. Create a feature branch from `main`
+2. Make your changes
+3. Ensure all checks pass
+4. Submit a pull request with a clear description
+5. Wait for review
+
+## Commit Messages
+
+Use clear, descriptive commit messages:
+
+- `feat: add bulk promotion support`
+- `fix: resolve member pagination issue`
+- `docs: update API documentation`
+- `refactor: simplify audit log queries`
+
+## Reporting Issues
+
+When reporting issues, please include:
+
+- Steps to reproduce
+- Expected behavior
+- Actual behavior
+- Browser/OS information
+- Screenshots if applicable
+
+## Code of Conduct
+
+Be respectful and constructive. We're building something great together.

Dockerfile

@@ -0,0 +1,37 @@
+FROM node:20-alpine AS base
+
+FROM base AS deps
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+RUN npx prisma generate
+RUN npm run build
+
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+COPY --from=builder /app/prisma ./prisma
+COPY --from=builder /app/node_modules/.prisma ./node_modules/.prisma
+
+USER nextjs
+
+EXPOSE 3000
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+CMD ["node", "server.js"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vortex Sinclair
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.