basic-react-starter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Zain Sajid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# basic-react-starter
+
+A minimal React + TypeScript + Vite boilerplate with everything wired up and ready to go.
+
+## Usage
+
+```bash
+npx basic-react-starter my-app
+cd my-app
+yarn install
+yarn dev
+```
+
+## Stack
+
+- **React 19** — UI library
+- **Vite 7** — Build tool
+- **TypeScript** — Type safety
+- **TanStack Router** — Type-safe routing
+- **TanStack Query** — Data fetching
+- **Zustand** — State management
+- **Tailwind v4** — Styling
+- **next-themes** — Theme switching
+- **Axios** — HTTP client with interceptors
+- **Sonner** — Toast notifications
+- **Motion** — Animations
+- **shadcn/ui** — Component library
+- **React Hook Form + Yup** — Form handling
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { execSync } from "child_process";
+import path from "path";
+import fs from "fs";
+import degit from "degit";
+
+// ─── Args ─────────────────────────────────────────────────────────────────────
+
+const projectName = process.argv[2];
+
+if (!projectName) {
+  console.error("\n  Usage: npx basic-react-starter <project-name>\n");
+  process.exit(1);
+}
+
+const targetDir = path.resolve(process.cwd(), projectName);
+
+if (fs.existsSync(targetDir)) {
+  console.error(`\n  Error: Directory "${projectName}" already exists.\n`);
+  process.exit(1);
+}
+
+// ─── Clone ────────────────────────────────────────────────────────────────────
+
+// TODO: replace with your actual GitHub username
+const GITHUB_REPO = "MuhammadZainSajid/basic-react-starter";
+
+console.log(`\n  Creating project in ./${projectName}...\n`);
+
+const emitter = degit(GITHUB_REPO, { cache: false, force: true });
+
+emitter.on("info", (info) => {
+  console.log(`  ${info.message}`);
+});
+
+try {
+  await emitter.clone(targetDir);
+} catch (err) {
+  console.error("\n  Failed to clone template:", err.message);
+  process.exit(1);
+}
+
+// ─── Update package.json ──────────────────────────────────────────────────────
+
+const pkgPath = path.join(targetDir, "package.json");
+
+if (fs.existsSync(pkgPath)) {
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+  pkg.name = projectName;
+  pkg.version = "0.0.0";
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+}
+
+// ─── Done ─────────────────────────────────────────────────────────────────────
+
+console.log(`
+  ✔ Done! Your project is ready.
+
+  Next steps:
+
+    cd ${projectName}
+    yarn install
+    yarn dev
+`);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "basic-react-starter",
+  "version": "1.0.0",
+  "description": "A minimal React + TypeScript + Vite starter with TanStack Router, Zustand, Tailwind v4, and more.",
+  "type": "module",
+  "bin": {
+    "basic-react-starter": "bin/index.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "dependencies": {
+    "degit": "^2.8.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "react",
+    "vite",
+    "typescript",
+    "tanstack-router",
+    "zustand",
+    "tailwind",
+    "boilerplate",
+    "starter"
+  ],
+  "author": "Muhammad Zain Sajid",
+  "license": "MIT"
+}