Skip to content

Latest commit

ย 

History

110 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽจ QuickDoodle โ€” AI-Powered Real-Time Drawing & Guessing Game

QuickDoodle is a fast, fun and modern real-time drawing & guessing web game inspired by Skribbl.io. Draw on a shared canvas, guess words, compete in private rooms or global rooms, and enjoy themed prompts and creative rounds.

Screenshot 2026-07-23 at 10 57 53โ€ฏAM

๐Ÿง  Built-in AI Support: QuickDoodle includes AI-powered drawing analysis and guessing through locally hosted LLMs (such as Ollama). Running AI locally avoids cloud API costs, rate limits, RPM/RPD restrictions, latency issues, and external service dependencies while providing a more private and developer-friendly experience.


โœจ Features (Frontend)

  • โšก Built with Next.js + TypeScript
  • ๐ŸŽฎ Real-time drawing & guessing using Socket.IO Client
  • ๐Ÿ–Œ๏ธ Interactive HTML canvas with smooth pens & eraser tools
  • ๐ŸŒ Private rooms or global public rooms
  • ๐Ÿงฉ Word prompts & theme-based drawing rounds
  • ๐Ÿงญ Modern UI + responsive layout
  • ๐Ÿ”ฅ Powered by Turbopack (Next.js dev bundler) for super-fast development reloads
  • ๐Ÿค– AI-powered drawing guessing using locally hosted LLMs (Ollama)
  • ๐Ÿ”’ Privacy-friendly AI processing with no cloud AI dependency

๐Ÿ› ๏ธ Tech Stack

Category Tools Used
Framework Next.js (App Router)
Language TypeScript
Real-time Sync Socket.IO Client
Styling / UI Tailwind CSS, custom components
AI Integration Ollama (Local LLMs)
Dev Bundler Turbopack (Next.js)

๐Ÿ“ฆ Installation & Running Locally

  1. Install dependencies:
npm install
# or
yarn
# or
pnpm install
# or
bun install
  1. Run development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
  1. Open your browser & navigate to:

๐Ÿ‘‰ http://localhost:3000

The app auto-reloads on file changes thanks to Next.js + Turbopack.


๐Ÿ“ Project Structure

/src
โ”œโ”€โ”€ app                     # Next.js App Router
โ”‚   โ”œโ”€โ”€ game                # Page route: /game/[roomid]
โ”‚   โ”œโ”€โ”€ globals.css
โ”‚   โ”œโ”€โ”€ layout.tsx          # Root layout
โ”‚   โ”œโ”€โ”€ not-found.tsx       # 404 handler
โ”‚   โ””โ”€โ”€ page.tsx            # Landing page
โ”‚
โ”œโ”€โ”€ components              # Reusable UI components
โ”‚   โ”œโ”€โ”€ Alert
โ”‚   โ”œโ”€โ”€ Button
โ”‚   โ”œโ”€โ”€ Loader
โ”‚   โ”œโ”€โ”€ Modal
โ”‚   โ”œโ”€โ”€ Toggle
โ”‚   โ”œโ”€โ”€ Tooltip
โ”‚   โ””โ”€โ”€ gamePage            # Game-specific UI
โ”‚
โ”œโ”€โ”€ context                 # React context providers (Theme, Game state... soon)
โ”‚
โ”œโ”€โ”€ hooks
โ”‚   โ””โ”€โ”€ useSocket.ts        # Custom Socket.IO hook (frontend)
โ”‚
โ”œโ”€โ”€ lib
โ”‚   โ””โ”€โ”€ socket.ts           # Socket instance + config
โ”‚
โ”œโ”€โ”€ types                   # TypeScript types
โ”‚   โ”œโ”€โ”€ app
โ”‚   โ”‚   โ”œโ”€โ”€ Alert
โ”‚   โ”‚   โ”œโ”€โ”€ Button
โ”‚   โ”‚   โ”œโ”€โ”€ Game
โ”‚   โ”‚   โ”œโ”€โ”€ Modal
โ”‚   โ”‚   โ”œโ”€โ”€ Toggle
โ”‚   โ”‚   โ””โ”€โ”€ Tooltip
โ”‚   โ””โ”€โ”€ auth
โ”‚
โ””โ”€โ”€ views                   # Page-level view components
    โ”œโ”€โ”€ app
    โ”‚   โ”œโ”€โ”€ GamePage
    โ”‚   โ””โ”€โ”€ LandingPage
    โ””โ”€โ”€ auth


๐ŸŒ Backend Repository

The backend (Node.js + Socket.IO + MongoDB) handles room logic, game state & events.

๐Ÿ”— Backend repo link


๐Ÿค– Local AI Integration

QuickDoodle supports AI-powered drawing guessing through locally hosted language models using Ollama.

Why Local AI?

Instead of relying on cloud AI providers, the AI runs directly on your machine:

  • No API costs
  • No RPM (Requests Per Minute) limitations
  • No RPD (Requests Per Day) limitations
  • Lower latency during gameplay
  • Better privacy and data control
  • Works without external AI subscriptions
  • Easy experimentation with different open-source models

This makes QuickDoodle ideal for development, testing, personal deployments, and AI experimentation without worrying about cloud usage limits or recurring costs.


๐Ÿค Contributions

Feel free to open issues or PRs โ€” suggestions and improvements are welcome!


๐Ÿง  Future Enhancements (Planned)

  • Smarter AI agents with improved drawing interpretation
  • Multiple AI personalities and difficulty levels
  • Save past rounds / game history
  • AI-vs-Human game modes
  • Custom community word packs

โญ If you like the project, give the repo a star ๐Ÿ™‚!


About

๐ŸŽจ QuickDoodle is a real-time multiplayer drawing & guessing web app inspired by Skribbl.io โ€” fast, simple, and modern. Draw on a shared canvas or solve creative riddles. Compete in private rooms with friends, join global public rooms to play with anyone or play against AI agents.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages