hacker-saran/react-vite-tailwind-pnpm-template

This repository is a starter template for building a React web frontend. It comes preconfigured with Vite as the build tool, TypeScript for typed JavaScript, Tailwind CSS version 4 for styling, and Vitest for running tests. The goal is to give a new project a consistent, working setup from the very first commit instead of assembling these tools by hand each time. The code is organized into clear layers: components for reusable interface pieces, hooks and a store for shared application state, services for talking to a backend over fetch or axios, and pages that combine everything into full screens. This structure is meant to keep the interface, the state management, and the network calls separate from each other so the codebase stays easy to follow as it grows larger. A notable part of this template is a docs folder written specifically to give AI coding assistants context about the project's conventions, such as where different types of files belong and how they should be named. The idea is that tools like Cursor or GitHub Copilot can read these documents and follow the project's rules more closely when generating new code for you. The template also sets up Git hooks using Husky, so that before you commit, your changed files are automatically linted and formatted, and the whole project is type checked. Before you push, the entire codebase is linted, type checked, tested, and built to catch problems before they reach a shared branch. Commit messages are checked against the Conventional Commits format automatically. To use it, you need Node.js and the pnpm package manager, since the hook scripts are written specifically around pnpm and its lock file. After running pnpm install, the Git hooks are set up automatically, and you can start a local development server, run the test suite, or build a production bundle using the provided pnpm scripts included in the template.