An AI-powered competitive debate training platform. Practice structured debates against an intelligent opponent, receive real-time argument analysis with scoring across logic, evidence, clarity, and persuasiveness, and track your improvement over time.

• Multiple Debate Formats — Oxford, Lincoln-Douglas, Parliamentary, and Public Forum
• AI Opponent — Debate against a GPT-powered adversary that adapts to your arguments
• Real-Time Argument Analysis — Each argument is scored on logic, evidence, clarity, and persuasiveness
• Fallacy Detection — Automatic identification of logical fallacies in your arguments
• Practice Mode — Standalone argument analyzer with counter-argument generation
• Topic Generation — Browse curated topics or generate new ones by category
• Session History — Review past debates with detailed scoring and feedback
• User Statistics — Track win rate, streaks, average scores, and progression
• Dark Mode — Full light/dark theme support

• Node.js 20+
• PostgreSQL database
• OpenAI API key

git clone https://github.com/saanvick1/DebateForge.git
cd DebateForge
npm install

Create a .env file in the root directory:

DATABASE_URL=postgresql://user:password@localhost:5432/debateforge
OPENAI_API_KEY=sk-your-openai-api-key

npm run db:push

npm run dev

The app will be available at http://localhost:5000.

npm run build
npm start

├── client/ # React frontend (Vite)
│ ├── src/
│ │ ├── components/ # UI components (shadcn/ui + custom)
│ │ ├── pages/ # Route pages
│ │ ├── hooks/ # Custom React hooks
│ │ └── lib/ # Utilities
│ └── public/ # Static assets
├── server/ # Express backend
│ ├── routes.ts # API route definitions
│ ├── storage.ts # Database interface + implementation
│ ├── openai.ts # OpenAI integration
│ └── db.ts # Database connection
├── shared/ # Shared TypeScript types
│ └── schema.ts # Drizzle ORM schema + Zod validators
└── package.json

MIT