Architecture Decisions

Technology choices and architectural decision records with commit evidence

React
Frontend
Supabase
Backend
Vercel
Deployment
Gemini
AI/LLM

Technology Stack Evolution

Current Technology Stack

Frontend Framework React 18 + Vite
UI Components ShadcnUI + Tailwind CSS
Database & Auth Supabase
API Integration @agentic/arxiv
LLM Integration Gemini 1.5 Flash
Deployment Vercel

Evolution Timeline

Era 1: Foundation (July 2024)

React + Vite + ShadcnUI + Tailwind CSS

Commit: d3b81af

Era 2: API Integration (April 2025)

ArXiv API + @agentic/arxiv library

Commit: 6b4f7c8

Era 3: Database Migration (May 2025)

localStorage → Supabase + Authentication

Commit: c6047e3

Era 4: LLM Enhancement (May 2025)

Gemini 1.5 Flash integration

Commit: a4d02fe

Key Architectural Decisions

React + Vite

Chosen for modern development experience, fast HMR, and excellent ecosystem support.

Decision Date: July 2024
Commit: d8988fa

ShadcnUI + Tailwind

Modern component library with utility-first CSS for rapid development and consistent design.

Decision Date: July 2024
Commit: d3b81af

Supabase

Migrated from localStorage to Supabase for scalable database, authentication, and real-time features.

Decision Date: May 2025
Commit: c6047e3