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 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

Getting Started

Prerequisites

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

Installation

1. Clone the repository:

   git clone https://github.com/lklynet/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 pull
docker compose up

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.

License

This project is available under the MIT License.