Imported from Turskyi/nextjs_gpt3 (AGENTS.md). Install upstream with npx skills add Turskyi/nextjs_gpt3. Copyright stays with the author.

AGENTS.md - Politer AI

Project Overview

Politer AI is a Next.js monolith (Pages Router) that rewrites rude or blunt messages into polite ones using high-performance open-source models. It is deployed automatically to Vercel on every push to master.

Developer Workflows

npm run dev      # Start local dev server at http://localhost:3000
npm run build    # Production build
npm run lint     # ESLint via next lint

No test suite exists. There is no src/ directory - all source lives at the project root.

Environment Variables

GEMINI_API_KEY, GROQ_API_KEY, and MISTRAL_API_KEY must be set locally (e.g. in .env.local). The application uses Groq as the primary provider, with Mistral and Gemini as fallbacks.

Architecture & Data Flow

Browser (pages/index.tsx)
  → GET /api/polite?prompt=<text>   (pages/api/polite.ts)
    → Primary: Groq (qwen/qwen3.8-27b)
    → Fallback 1: Mistral AI (mistral-small-latest)
    → Fallback 2: Google Generative AI (gemini-3.5-flash-lite)
    ← { politerMessage: string }
  ← renders polite message in UI

The only API route is pages/api/polite.ts.
Prompt validation lives in both the frontend (index.tsx) and the API handler - keep them in sync with INPUT_MAX_LENGTH from constants.ts.

Key Files

File	Purpose
`constants.ts`	Shared constants (`INPUT_MAX_LENGTH=700`, `DATE_UPDATED`, `TELEGRAM_LINK`)
`pages/api/polite.ts`	Orchestrates AI calls; handles input validation and provider fallback
`services/`	AI provider implementations (Groq, Mistral, Gemini)
`pages/index.tsx`	Main UI; form, loading state, result display
`pages/_app.tsx`	Global layout: Bootstrap CSS import, Inter font, `NextNProgress` bar
`next.config.js`	`remotePatterns` allows `play.google.com` images
`tailwind.config.ts`	DaisyUI custom `lightTheme` palette; content paths point to `src/` (unused)

Styling Conventions

Primary: CSS Modules (styles/*.module.css) - all page-level styles live here.
UI components: react-bootstrap (Button, Form, Spinner, Container) with Bootstrap CSS imported globally in _app.tsx.
Tailwind/DaisyUI: Installed and configured with a custom lightTheme, but the content paths in tailwind.config.ts point to src/ which does not exist - Tailwind utilities are not purged/applied to current page files. Do not introduce Tailwind utility classes in pages/ without fixing the content paths first.
Prettier enforces singleQuote: true for TS/TSX and double quotes for CSS/JSON (see prettier.config.js).

Path Alias

@/ resolves to the project root (./*), e.g. import styles from '@/styles/Home.module.css'.

Installed-but-Unused Dependencies

next-auth, @auth/prisma-adapter, prisma, @prisma/client, and zod are in package.json but are not wired up in any current page or API route. Do not assume auth or database functionality exists.

Static Pages

privacy-policy, privacy-policy-android, terms-of-service, support, 404, 500 are standalone pages with no shared layout component beyond _app.tsx.

nextjs_gpt3

About