Skip to content
This repository was archived by the owner on Jun 6, 2025. It is now read-only.

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!

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •