CrossCribb.Click 🎮

The ultimate scoring companion for Cribbage and Cross-Crib games

🚀 Quick Start

# Clone the repository
git clone https://github.com/kr3t3n/crosscribb.git

# Navigate to project directory
cd crosscribb

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:5173 to see the app running.

🎯 Features

• Multiple Game Modes

  • Traditional Cribbage (121 points)
  • Cross-Crib (61 points)

• Flexible Player Options

  • 2-player games
  • 2-team games (4 players)

• Smart Scoring

  • Real-time score tracking
  • Automatic dealer rotation
  • Round history
  • Game statistics

• Modern UI/UX

  • Dark/Light theme
  • Responsive design
  • Touch-friendly
  • Progressive Web App

🛠️ Tech Stack

• Frontend: React 18 with TypeScript
• Styling: Tailwind CSS
• Build Tool: Vite
• Icons: Lucide React
• State Management: React Context API
• Storage: Local Storage
• Deployment: Netlify

📦 Project Structure

crosscribb/
├── src/
│   ├── components/    # Reusable UI components
│   ├── contexts/     # React contexts
│   ├── pages/        # Page components
│   ├── types/        # TypeScript types
│   ├── utils/        # Utility functions
│   ├── App.tsx       # Main app component
│   └── main.tsx      # Entry point
├── public/           # Static assets
└── package.json      # Dependencies and scripts

🔧 Development

# Run development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

# Lint code
npm run lint

📱 PWA Support

CrossCribb.Click is a Progressive Web App (PWA) that can be installed on mobile devices and desktop computers. To install:

1. Visit the website in a supported browser
2. Click the "Add to Home Screen" prompt
3. Enjoy offline access and app-like experience

🤝 Contributing

1. Fork the repository
2. Create a new branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Card game icons by Lucide
• UI inspiration from modern scoring apps
• The cribbage community for feedback and support

📬 Contact

Mangia Studios Limited - @georgipep

Project Link: https://github.com/kr3t3n/crosscribb

---

Made with ❤️ by Mangia Studios Limited