Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⊙ Dobble Mint (Spot It Card Generator)

A premium single-page application for generating custom Spot It (also known as Dobble) game cards. Built with pure mathematics and modern web technologies.

alt text

🧬 The Mathematics

The "magic" behind Spot It is based on Finite Projective Planes.

  • Each card represents a line in the projective plane.
  • Each symbol represents a point in the projective plane.
  • By the axioms of projective geometry, any two lines intersect at exactly one point.
  • This translates to: Any two cards share exactly one symbol in common.

This generator currently supports prime orders $n \in {2, 3, 5, 7, 11, 13}$.

  • Total Cards: $n^2 + n + 1$
  • Symbols per Card: $n + 1$
  • Total Unique Symbols: $n^2 + n + 1$

✨ Features

  • Mathematical Precision: Generates valid incidence structures for various orders.
  • Symbol Themes: Choose from curated emoji sets (Animals, Nature, Food, Objects, etc.).
  • Card Shapes: Generate cards as Circles, Squares, Hexagons, or Octagons.
  • Layout Engines:
    • Ring: Classic Spot It layout with a center symbol.
    • Grid: Orderly placement for clarity.
    • Random: Poisson-disk sampling for a more organic feel.
  • Deep Customization:
    • Dynamic size variance sliders to normalize scaling.
    • Granular symbol rotation bounds.
  • High-Quality PDF Export: Hardware-accelerated canvas rasterization generates incredibly crisp, print-ready PDFs (with optional bleed marks) while perfectly preserving complex system emojis without bloating file sizes.

🚀 Getting Started

Simply open index.html in any modern web browser. No server or installation required!

Local Development

The project is built with:

  • Core: HTML5, CSS3, Vanilla JavaScript.
  • PDF Engine: jsPDF (using high-fidelity canvas rasterization).
  • Fonts: Inter (via Google Fonts).

🛠️ Project Structure

dobble-mint/
├── index.html       # Main application shell
├── css/
│   └── style.css    # Solarized Dark design system
└── js/
    ├── math.js      # Projective plane construction engine
    ├── symbols.js   # Unicode/Emoji pool management
    ├── renderer.js  # SVG card rendering logic
    ├── pdf.js       # PDF assembly and export
    └── app.js       # UI orchestration & state management

📝 License

MIT License - feel free to use and modify for your own game nights!

About

An application for generating custom Spot It game cards. Also known as Dobble.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages