Skip to content

scshiv29-dev/sudoken

Repository files navigation

Here’s a README template for your Sudoken app that you can use on GitHub:


Sudoken

Spell Check Vercel

Sudoken Logo

Sudoken is a modern and minimalist Sudoku game built as a Progressive Web App (PWA) using Next.js. It offers a clean interface for users to play Sudoku puzzles, along with a hint system to assist players in solving the game. The app is designed to work on phones , providing a seamless experience on both desktop and mobile devices.

Features

  • PWA Support: Installable as a web app on mobile and desktop devices.
  • Hint System: Get hints to solve the puzzle.
  • Multiple Difficulty Levels: Choose from easy, medium, and hard puzzles.
  • Minimalist Design: Clean and user-friendly UI for a smooth gaming experience.

Demo

You can view a live demo of the app here: sudoken.xyz

Installation

To get started with the Sudoken app locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/your-username/sudoken.git
    cd sudoken
  2. Install dependencies:

    yarn install
  3. Run the development server:

    yarn run dev

    Open http://localhost:3000 with your browser to see the app in action.

  4. Build the app for production:

    yarn run build
  5. Start the production server:

    yarn start

Progressive Web App (PWA)

Sudoken is a PWA, which means it can be installed on your device and run offline.

  • On mobile devices, you can add Sudoken to your home screen for a native app-like experience.
  • On desktop, you can install it via your browser to have it accessible like an app.

Technology Stack

  • Framework: Next.js
  • State Management: React Hooks
  • Progressive Web App: Service Worker for offline capabilities
  • UI: Minimalist design with custom CSS

Contributing

Contributions are welcome! If you have suggestions or want to improve the app, feel free to fork the repo and submit a pull request.

  1. Fork the repository.
  2. Create your feature branch: git checkout -b feature/your-feature-name.
  3. Commit your changes: git commit -m 'Add some feature'.
  4. Push to the branch: git push origin feature/your-feature-name.
  5. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For any questions or suggestions, feel free to reach out:


Feel free to adjust this to suit your project's specific details, and replace placeholders with your own links and information!