Skip to content

badbadkai/clack

Repository files navigation

Clack

Find your rhythm.

Clack is a next-generation typing test platform built for serious typists who care about speed, precision, and competition.

Features

Solo Mode

  • Time-based tests (15s, 30s, 60s, 120s)
  • Word-based tests (10, 25, 50, 100 words)
  • Multiple difficulty levels (Common, Standard, Advanced, Expert)
  • Optional punctuation and numbers
  • Live WPM, accuracy, and timer display
  • Post-test WPM graph and detailed statistics

Themes

12 beautiful themes with light and dark variants:

  • Ink (default) - Warm, grounded, literary
  • Carbon - Technical, precise, neutral
  • Ember - Cozy, campfire, evening
  • Frost - Winter, crisp, sharp
  • Moss - Natural, earthy, calm
  • Noir - High contrast, stark, dramatic
  • Neon - Vibrant, energetic, cyberpunk
  • Dusk - Dreamy, twilight, serene
  • Copper - Industrial, vintage, mechanical
  • Terminal - Retro, hacker, CRT nostalgia
  • Sand - Desert, minimal, zen
  • Storm - Moody, electric, powerful

Coming Soon

  • Ranked competitive mode with ELO matchmaking
  • Play with Friends (private rooms)
  • Custom mode configuration
  • User accounts and profiles
  • Global leaderboards

Tech Stack

  • Frontend: React + TypeScript, Tailwind CSS, Framer Motion
  • Backend: Fastify, Socket.io, PostgreSQL, Redis
  • Architecture: Monorepo with shared types

Development

Prerequisites

  • Node.js 20+
  • pnpm 8+
  • Docker (for local database)

Setup

# Clone the repository
git clone https://github.com/badbadkai/clack.git
cd clack

# Install dependencies
pnpm install

# Start local databases
docker-compose up -d

# Run development servers
pnpm dev

Project Structure

clack/
├── packages/
│   ├── web/          # React frontend
│   ├── server/       # Fastify backend
│   └── shared/       # Shared types and utilities
└── docker-compose.yml

Keyboard Shortcuts

Shortcut Action
Tab + Enter Restart test
Esc Back to menu
1-4 Quick navigation (main screen)

License

MIT


Built with ❤️ and mechanical keyboards.

About

Clack

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages