itemdeck.app

Interactive Card Collection Viewer
Display, explore, and play with card collections from any GitHub repository.

---

What is itemdeck.app?

itemdeck.app is a browser-based card display system that loads collections from GitHub repositories. Perfect for:

• Collectors - Browse and organise your collections
• Curators - Share themed collections with others
• Gamers - Play memory games with your cards

Features

• Card Display - Responsive grid with smooth animations and flip effects
• Multiple Views - Grid, Stack, Carousel, and Fit-to-Viewport layouts
• Discovery Tools - Search, filter by category/platform/year, and grouping
• Gaming Mechanics - Multiple game mechanics including Memory and Snap Ranking
• Remote Collections - Load any GitHub-hosted collection via URL
• Keyboard Navigation - Full keyboard support
• Theme Support - Light, dark, and high contrast modes
• Offline Caching - Collections cached locally for fast reloading
• Accessibility - WCAG 2.1 AA compliant with reduced motion support

Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Open http://localhost:5173 in your browser

Load a Collection

Load remote collections using simplified URL formats:

# Short query format
http://localhost:5173/gh?u=REPPL&c=retro/games/

# Clean path format
http://localhost:5173/gh/REPPL/c/retro/games/

# Nested folders supported
http://localhost:5173/gh/REPPL/c/retro/games/my-collection

Documentation

• Getting Started - Quick start tutorial
• Keyboard Shortcuts - Navigation reference
• Search and Filters - Finding cards
• Schema Reference - Collection data format

Contributing

For developers and contributors:

• Development Guide - Technical documentation
• Available Scripts - npm commands
• Architecture - Project structure and patterns
• Roadmap - Planned features

Requirements

• Node.js 20.0.0 or higher
• npm (included with Node.js)