Spider Solitaire

A modern, open-source Spider Solitaire app focused on local practice play.

Features

• Classic Gameplay: Authentic Spider Solitaire rules and mechanics.
• Single Local Mode:
  • random practice boards with persistent local stats
• Smart Features:
  • undo system
  • smart hints
  • automatic run detection
• Customization:
  • multiple color themes
  • customizable card backs
• Persistence:
  • local game state and stats in the browser

Tech Stack

• Frontend: React 19
• Build Tool: Vite
• Language: TypeScript
• Styling: Tailwind CSS
• State Management: Zustand
• Icons: Lucide React
• Utilities: date-fns, clsx

Getting Started

Prerequisites

• Node.js (Latest LTS version recommended)
• npm

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/spider-solitaire.git
   cd spider-solitaire

2. Install dependencies:

   npm install

3. Start the frontend:

   npm run dev

4. Open your browser and navigate to http://localhost:5173.

Dev Commands

npm run dev
npm run build
npm run preview

Docker Deployment

Run the local-only app as a single containerized web service:

docker compose up --build

Then open http://localhost:8080.

Building for Production

To create an optimized production build:

npm run build

The build artifacts will be stored in the dist/ directory.

Open Source

This project is open source software. We believe in the power of community and transparent development.

• Learn: Explore the source code to see how a modern React game is architected.
• Contribute: Bug reports, feature requests, and pull requests are welcome!
• Modify: Feel free to fork the repository and customize the game to your liking.

License

This project is available under the MIT License.