Flippy

Flippy is a Next.js learning platform focused on flashcard-based study flows. The project uses the App Router, Tailwind CSS, shadcn/ui, TanStack Query, Zustand, and a feature-based src structure inspired by the BEM-FTEIC website repo style.

Stack

• Next.js 15
• React 19
• TypeScript
• Tailwind CSS
• shadcn/ui
• TanStack Query
• Zustand
• Lucide React

Project Structure

src/
  app/
  components/
  features/
    auth/
    courses/
    flashcards/
    home/
    shared/
  layouts/
  lib/
  types/

Getting Started

npm install
npm run dev

Open http://localhost:3000.

Available Scripts

npm run dev
npm run build
npm run start
npm run lint
npm run typecheck

Environment Variables

Copy .env.example to .env.local when needed.

NEXT_PUBLIC_APP_NAME=Flippy
NEXT_PUBLIC_APP_URL=http://localhost:3000

Quality Tooling

• Husky for local git hooks
• lint-staged for pre-commit checks
• Commitlint for conventional commits
• GitHub Actions CI for lint, typecheck, build

Sitemap

next-sitemap runs after production builds and generates sitemap metadata based on the configured site URL.

License

This project is licensed under the MIT License.