create-rvp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mostafa Khaled
+
+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,158 @@
+# crvp CLI
+
+Interactive CLI for creating modern React + Vite projects with optional Tailwind CSS, Redux, React Query, and more.
+
+[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://www.npmjs.com/package/crvp)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+
+## 🚀 Features
+
+- **Interactive Prompts** - Guided project setup with beautiful CLI interface
+- **Vite-powered** - Fast, modern build tool with HMR
+- **TypeScript Support** - Optional TypeScript scaffolding
+- **Modern Stack** - React 19, React Compiler, Tailwind CSS
+- **State Management** - Optional Redux Toolkit integration
+- **Data Fetching** - React Query (TanStack Query) + Axios
+- **Form Handling** - React Hook Form with Zod validation
+- **Routing** - React Router setup
+- **Linting** - ESLint + Prettier configuration
+- **Flexible Structure** - Simple or scalable folder architecture
+
+## 📦 Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g create-rvp
+# or
+pnpm add -g create-rvp
+# or
+yarn global add create-rvp
+```
+
+### Using npx (No Installation)
+
+```bash
+npx create-rvp [project-name]
+```
+
+## 🛠️ Usage
+
+### Create a new project
+
+```bash
+# With interactive prompts
+create-rvp
+
+# With project name argument
+create-rvp my-awesome-app
+```
+
+### Options
+
+The CLI will guide you through selecting:
+
+| Option | Description |
+|--------|-------------|
+| Package Manager | pnpm (default), npm, yarn, or bun |
+| TypeScript | Enable TypeScript support |
+| React Compiler | Enable React 19 compiler optimizations |
+| Tailwind CSS | Add Tailwind CSS for styling |
+| React Router | Include client-side routing |
+| React Query + Axios | Add TanStack Query and Axios for data fetching |
+| Redux Toolkit | Include Redux for global state management |
+| React Hook Form + Zod | Form handling with schema validation |
+| ESLint + Prettier | Code linting and formatting setup |
+| Folder Structure | Simple (flat) or Scalable (feature-based) |
+
+## 📁 Project Structure
+
+### Simple Structure
+```
+src/
+├── components/
+├── pages/
+├── hooks/
+├── utils/
+├── styles/
+└── App.tsx
+```
+
+### Scalable Structure
+```
+src/
+├── features/
+│   └── feature-name/
+│       ├── components/
+│       ├── hooks/
+│       └── api/
+├── shared/
+│   ├── components/
+│   ├── hooks/
+│   └── utils/
+└── App.tsx
+```
+
+## 🧰 Technologies
+
+- [Vite](https://vitejs.dev/) - Next Generation Frontend Tooling
+- [React](https://react.dev/) - A JavaScript library for building user interfaces
+- [TypeScript](https://www.typescriptlang.org/) - Typed JavaScript
+- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework
+- [React Query](https://tanstack.com/query) - Powerful asynchronous state management
+- [Redux Toolkit](https://redux-toolkit.js.org/) - State management made simple
+- [React Hook Form](https://react-hook-form.com/) - Performant forms
+- [Zod](https://zod.dev/) - TypeScript-first schema validation
+- [React Router](https://reactrouter.com/) - Declarative routing
+
+## 🧑‍💻 Development
+
+### Prerequisites
+
+- Node.js >= 18
+- pnpm (recommended), npm, or yarn
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/M0stafa-Khaled/create-rvp.git
+cd create-rvp
+
+# Install dependencies
+pnpm install
+
+# Run in development mode
+pnpm dev
+
+# Build for production
+pnpm build
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `pnpm dev` | Run CLI in development mode with tsx |
+| `pnpm start` | Run compiled CLI |
+| `pnpm build` | Build for production with tsup |
+| `pnpm lint` | Run ESLint |
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## � License
+
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 👤 Author
+
+**Mostafa Khaled**
+
+- GitHub: [@M0stafa-Khaled](https://github.com/M0stafa-Khaled)
+
+---
+
+<p align="center">Built with ❤️ for the React community</p>

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/cli.js");

package/dist/cli.js

@@ -0,0 +1,459 @@
+#!/usr/bin/env node
+import*as ie from"@clack/prompts";import{program as Re}from"commander";import*as c from"@clack/prompts";import M from"picocolors";var _=async e=>{c.intro(M.bold("\u{1F680} Welcome to crvp CLI!")),c.note(`Interactive scaffolding for modern React + Vite projects
+with Tailwind, Redux, React Query, etc.`,"crvp v0.1.0");let r,t=d=>/^(?:[a-z0-9]+(?:-[a-z0-9]+)*)$/.test(d),a=d=>d==="."||d==="..";if(e&&e.trim()!==""){let d=e.trim();if(!a(d)&&!t(d))return c.log.error("Invalid project name. Use lowercase letters, numbers, hyphens, or '.' / '..'"),null;r=d,c.log.info(`Using project name from argument: ${M.cyan(r)}`)}else{let d=await c.text({message:"Project name (folder name):",placeholder:"my-crvp-app",defaultValue:"my-crvp-app",validate:$=>{let w=$?.trim();if(w&&!a(w)&&!t(w))return"Use lowercase letters, numbers, hyphens, or '.' / '..'"}});if(c.isCancel(d))return c.cancel("Operation cancelled."),null;let k=d.trim();r=k===""?"my-crvp-app":k,c.log.info(`Using project name: ${M.cyan(r)}`)}let s=await c.select({message:"Preferred package manager:",options:[{value:"pnpm",label:"pnpm (recommended - fastest)"},{value:"npm",label:"npm"},{value:"yarn",label:"Yarn"},{value:"bun",label:"Bun"}],initialValue:"pnpm"});if(c.isCancel(s))return c.cancel("Operation cancelled."),null;let o=await c.confirm({message:"Use TypeScript?",initialValue:!0});if(c.isCancel(o))return c.cancel("Operation cancelled."),null;let n=await c.confirm({message:"Use React Compiler?",initialValue:!1});if(c.isCancel(n))return c.cancel("Operation cancelled."),null;let p=await c.confirm({message:"Use Tailwind CSS?",initialValue:!0});if(c.isCancel(p))return c.cancel("Operation cancelled."),null;let u=await c.confirm({message:"Use React Router?",initialValue:!0});if(c.isCancel(u))return c.cancel("Operation cancelled."),null;let l=await c.confirm({message:"Use React Query (TanStack) + Axios?",initialValue:!0});if(c.isCancel(l))return c.cancel("Operation cancelled."),null;let i=await c.confirm({message:"Use Redux Toolkit?",initialValue:!1});if(c.isCancel(i))return c.cancel("Operation cancelled."),null;let m=await c.confirm({message:"Use react-hook-form + zod?",initialValue:!0});if(c.isCancel(m))return c.cancel("Operation cancelled."),null;let h=await c.confirm({message:"Setup ESLint + Prettier?",initialValue:!0});if(c.isCancel(h))return c.cancel("Operation cancelled."),null;let C=await c.select({message:"Folder structure style:",options:[{value:"simple",label:"Simple (flat, good for small/medium projects)"},{value:"scalable",label:"Scalable (feature-based, for larger projects)"}],initialValue:"simple"});return c.isCancel(C)?(c.cancel("Operation cancelled."),null):(c.outro(M.green("All answers collected! Starting scaffolding... \u{1F389}")),{projectName:r,packageManager:s,useTypescript:o,useReactCompiler:n,useTailwind:p,useRouter:u,useReactQueryAxios:l,useRedux:i,useRhformZod:m,useEslintPrettier:h,folderStructure:C})};import.meta.url===`file://${process.argv[1]}`&&(async()=>{let e=await _();e&&console.log(`
+Collected answers:`,e)})();import oe from"picocolors";import I from"fs/promises";import Ae from"path";import*as g from"@clack/prompts";import N from"picocolors";var ne=async e=>{let r=e.trim()||"my-crvp-app";for(;;){let t=Ae.resolve(process.cwd(),r);try{if(await I.access(t),(await I.readdir(t)).length===0)return t;g.note(`The directory ${N.cyan(r)} already exists and contains files.`,"Directory Conflict");let s=await g.select({message:"How do you want to proceed?",options:[{value:"overwrite",label:"Overwrite (delete existing content)"},{value:"new-name",label:"Choose a different name"},{value:"cancel",label:"Cancel"}],initialValue:"new-name"});if(g.isCancel(s)||s==="cancel")return g.cancel("Project creation cancelled."),null;if(s==="overwrite"){let n=await g.confirm({message:`Delete all files in ${N.cyan(r)}? This action cannot be undone.`,initialValue:!1});return g.isCancel(n)||!n?(g.cancel("Overwrite cancelled."),null):(g.log.warn("Deleting existing directory contents..."),await I.rm(t,{recursive:!0,force:!0}),await I.mkdir(t,{recursive:!0}),g.log.success(`Directory prepared: ${N.cyan(r)}`),t)}let o=await g.text({message:"Enter a new project name:",placeholder:"my-crvp-app-2",validate:n=>{let p=n?.trim();if(!p)return"Name is required";let u=i=>i==="."||i==="..",l=i=>/^(?:[a-z0-9]+(?:-[a-z0-9]+)*)$/.test(i);if(!u(p)&&!l(p))return"Use lowercase letters, numbers, hyphens, or '.' / '..'"}});if(g.isCancel(o))return g.cancel("Project creation cancelled."),null;r=o.trim()}catch(a){return a.code==="ENOENT"?(await I.mkdir(t,{recursive:!0}),g.log.success(`Created directory: ${N.cyan(r)}`),t):(g.log.error(`Error: ${a.message}`),null)}}};import{execa as Te}from"execa";import*as f from"@clack/prompts";import P from"fs/promises";import R from"path";import*as ce from"@clack/prompts";import je from"picocolors";var y=async(e,r,t,a="Failed")=>{let s=ce.spinner();s.start(e);try{let o=await t();return s.stop(r),o}catch(o){throw s.stop(`${je.red(a)}: ${o.message}`),o}};import{execa as Se}from"execa";import*as T from"@clack/prompts";import F from"fs/promises";import le from"path";var W=async(e,r)=>{if(!e.useTailwind)return!0;let t=e.packageManager,a=["tailwindcss","@tailwindcss/vite"],s=t,o=[t==="npm"?"install":"add","-D",...a];if(!await y(`Installing Tailwind CSS using ${t}...`,"Tailwind CSS installed successfully",async()=>(await Se(s,o,{cwd:r}),!0),"Failed to install Tailwind CSS"))return!1;let p=e.useTypescript?".ts":".js",u=le.join(r,`vite.config${p}`);try{await F.access(u);let i=await F.readFile(u,"utf-8");i.includes("tailwindcss from")||(i=`import tailwindcss from "@tailwindcss/vite";
+`+i),i.includes("tailwindcss()")||(i=i.replace(/plugins:\s*\[/,"plugins: [tailwindcss(),")),await F.writeFile(u,i),T.log.success(`Updated vite.config${p} with Tailwind plugin.`)}catch(i){return T.log.error(`Failed to update vite.config${p}: ${i.message}`),!1}let l=le.join(r,"src/index.css");try{await F.access(l),(await F.readFile(l,"utf-8")).includes('@import "tailwindcss"')?T.log.info("Tailwind already imported in src/index.css."):(await F.writeFile(l,`@import "tailwindcss";
+`),T.log.success("Added Tailwind import to src/index.css."))}catch(i){return T.log.error(`Failed to update src/index.css: ${i.message}`),!1}return!0};import{execa as ve}from"execa";import*as H from"@clack/prompts";import L from"fs/promises";import pe from"path";var G=async(e,r)=>{if(!e.useReactCompiler)return!0;let t=e.packageManager,a=["react-compiler-runtime@latest","babel-plugin-react-compiler@latest","eslint-plugin-react-compiler@latest"],s=t,o=["add","-D",...a];if(t==="yarn"&&(s="yarn"),t==="bun"&&(s="bun"),!await y(`Installing React Compiler using ${t}...`,"React Compiler packages installed",async()=>(await ve(s,o,{cwd:r}),!0),"Failed to install React Compiler packages"))return!1;let p=e.useTypescript?".ts":".js",u=pe.join(r,`vite.config${p}`);try{await L.access(u);let i=await L.readFile(u,"utf-8"),m=/react\s*\([^)]*\)\s*,?/g;i=i.replace(m,""),i=i.replace(/plugins:\s*\[/,`plugins: [
+    react({
+      babel: {
+        plugins: ["babel-plugin-react-compiler"],
+      },
+    }),`),await L.writeFile(u,i.trim()),H.log.success(`Updated vite.config${p} with React Compiler config.`)}catch(i){return H.log.error(`Failed to update vite.config${p}: ${i.message}`),!1}let l=pe.join(r,"eslint.config.js");try{try{await L.access(l)}catch{return!0}let i=await L.readFile(l,"utf-8");i.includes('from "eslint-plugin-react-compiler"')||(i=`import reactCompiler from "eslint-plugin-react-compiler";
+`+i),!i.includes('"react-compiler"')&&!i.includes("'react-compiler'")&&(i=i.replace(/plugins:\s*\[([^\]]*)\]/,(h,C)=>{let d=C.trim();return`plugins: [${d?`${d}, "react-compiler"`:'"react-compiler"'}]`})),i.includes("reactCompiler.configs.recommended")||(i=i.replace(/extends:\s*\[([^\]]*)\]/,(h,C)=>{let d=C.trim();return`extends: [${d?`${d} reactCompiler.configs.recommended`:"reactCompiler.configs.recommended"}]`}))}catch(i){H.log.warn(`Failed to update ESLint config: ${i.message}. Skipping React Compiler ESLint rules. Add manually if needed.`)}return!0};import A from"fs/promises";import z from"path";import*as q from"@clack/prompts";var K=async(e,r)=>{let t=e.folderStructure;q.note(`Setting up ${t} folder structure...`,"Structure");let a=e.useTypescript?"ts":"js",s=e.useTypescript?"tsx":"jsx",o=z.join(r,"src");try{try{await A.stat(`${o}/App.css`),await A.unlink(`${o}/App.css`)}catch{}try{await A.stat(`${o}/App.${s}`),await A.unlink(`${o}/App.${s}`)}catch{}if(await A.access(o),t==="simple"){let n=["components","components/ui",...e.useRedux?["store"]:[],"pages","lib","hooks",...e.useRouter?["routes"]:[],...e.useRhformZod?["validations"]:[],...e.useTypescript?["types"]:[]];for(let u of n){let l=z.join(o,u);await A.mkdir(l,{recursive:!0})}let p=[...e.useTypescript?["types/index.d.ts"]:[]];for(let u of p){let l=z.join(o,u);await A.writeFile(l,"")}}else{let n=["app",...e.useRedux?["app/store"]:[],"features","features/auth/pages","features/auth/components",...e.useTypescript?["features/auth/types"]:[],"shared/components/ui","shared/lib","shared/hooks","shared/utils",...e.useTypescript?["shared/types"]:[]];for(let u of n){let l=z.join(o,u);await A.mkdir(l,{recursive:!0})}let p=[...e.useRouter?[`app/router.${s}`]:[],`features/auth/api.${a}`,`features/auth/layout.${s}`,...e.useTypescript?["features/auth/types.d.ts"]:[],...e.useRouter?[`features/auth/routes.${s}`]:[],...e.useRhformZod?[`features/auth/schema.${a}`]:[],...e.useTypescript?["shared/types/index.d.ts"]:[],`shared/api.${a}`,...e.useReactQueryAxios?[`shared/queriesAndMutations.${a}`]:[]];for(let u of p){let l=z.join(o,u);await A.writeFile(l,"")}}return q.log.success(`${t} folder structure setup complete.`),!0}catch(n){return q.log.error(`Failed to setup folder structure: ${n.message}`),!1}};import{execa as Pe}from"execa";import*as O from"@clack/prompts";import ue from"fs/promises";import Z from"path";var Y=async(e,r)=>{if(!e.useRedux)return!0;O.note("Setting up Redux Toolkit...","Redux");let t=e.packageManager,a=e.useTypescript?"ts":"js",s=Z.join(r,"src"),o=["@reduxjs/toolkit","react-redux"],n=t,p=[t==="npm"?"install":"add",...o];if(!await y(`Installing Redux Toolkit & react-redux using ${t}...`,"Redux packages installed",async()=>(await Pe(n,p,{cwd:r}),!0),"Failed to install Redux packages"))return!1;let l=e.folderStructure==="simple",i=l?Z.join(s,"store"):Z.join(s,"app/store"),m=Z.join(i,`index.${a}`);try{await ue.mkdir(i,{recursive:!0});let h=`import { configureStore } from "@reduxjs/toolkit";
+${e.useTypescript?`import {
+  type TypedUseSelectorHook,
+  useDispatch,
+  useSelector,
+} from "react-redux";`:""}
+  
+export const store = configureStore({
+  reducer: {
+    // Add reducers here
+  },
+});
+  
+${e.useTypescript?`export type RootState = ReturnType<typeof store.getState>;
+export type AppDispatch = typeof store.dispatch;
+  
+export const useAppDispatch: () => AppDispatch = useDispatch;
+export const useAppSelector: TypedUseSelectorHook<RootState> = useSelector;`:""}
+  
+`;await ue.writeFile(m,h),O.log.success(`Created ${l?"store":"app/store"}/index.${a} (basic store)`)}catch(h){return O.log.error(`Failed to create store: ${h.message}`),!1}return!0};import{execa as $e}from"execa";import*as j from"@clack/prompts";import Q from"fs/promises";import v from"path";var X=async(e,r)=>{if(!e.useReactQueryAxios)return!0;j.note("Setting up React Query + Axios...","React Query");let t=e.packageManager,a=e.useTypescript?"ts":"js",s=v.join(r,"src"),o=["@tanstack/react-query","axios"],n=t,p=["add",...o];if(t==="yarn"&&(n="yarn"),t==="bun"&&(n="bun"),!await y(`Installing React Query + Axios using ${t}...`,"React Query & Axios installed",async()=>(await $e(n,p,{cwd:r}),!0),"Failed to install React Query packages"))return!1;let l=e.folderStructure==="simple",i=l?v.join(s,"lib"):v.join(s,"shared/lib"),m=v.join(i,`api.${a}`);try{await Q.mkdir(i,{recursive:!0}),await Q.writeFile(m,`import axios from "axios";
+
+export const api = axios.create({
+  baseURL: import.meta.env.VITE_API_URL || "http://localhost:3000",
+  timeout: 10000,
+  headers: {
+    "Content-Type": "application/json",
+  },
+});
+
+// Request interceptor to add auth token
+api.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem("token");
+    if (token) {
+      config.headers.Authorization = \`Bearer \${token}\`;
+    }
+    return config;
+  },
+  (error) => {
+    return Promise.reject(error);
+  }
+);
+
+// Response interceptor to handle errors
+api.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    if (error.response?.status === 401) {
+      // Handle unauthorized - redirect to login or refresh token
+      localStorage.removeItem("token");
+      window.location.href = "/auth/login";
+    }
+    return Promise.reject(error);
+  }
+);
+
+export default api;
+`),j.log.success(`Created ${l?"lib":"shared/lib"}/api.${a}`)}catch(d){return j.log.error(`Failed to create api instance: ${d.message}`),!1}let h=l?v.join(s,"lib"):v.join(s,"shared/lib"),C=v.join(h,`queryClient.${a}`);try{await Q.mkdir(h,{recursive:!0}),await Q.writeFile(C,`import { QueryClient } from "@tanstack/react-query";
+
+export const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: 1,
+      staleTime: 1000 * 60, // 1 minute
+      gcTime: 1000 * 60 * 5, // 5 minutes
+      refetchOnWindowFocus: true,
+      refetchOnReconnect: true,
+      refetchOnMount: true,
+    },
+  },
+});
+`),j.log.success(`Created ${l?"lib":"shared/lib"}/queryClient.${a}`)}catch(d){return j.log.error(`Failed to create queryClient: ${d.message}`),!1}if(!l){let d=v.join(s,`shared/queriesAndMutations.${a}`);try{let k=`import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { api } from "./api";
+
+// Example query hook
+export const useExampleQuery = () => {
+  return useQuery({
+    queryKey: ["example"],
+    queryFn: async () => {
+      const { data } = await api.get("/example");
+      return data;
+    },
+  });
+};
+
+// Example mutation hook
+export const useExampleMutation = () => {
+  const queryClient = useQueryClient();
+  
+  return useMutation({
+    mutationFn: async (payload${e.useTypescript?": unknown":""}) => {
+      const { data } = await api.post("/example", payload);
+      return data;
+    },
+    onSuccess: () => {
+      // Invalidate and refetch
+      queryClient.invalidateQueries({ queryKey: ["example"] });
+    },
+  });
+};
+`;await Q.writeFile(d,k),j.log.success(`Created shared/queriesAndMutations.${a}`)}catch(k){return j.log.error(`Failed to create queriesAndMutations: ${k.message}`),!1}}return!0};import{execa as be}from"execa";import*as b from"@clack/prompts";import me from"fs/promises";import ee from"path";var te=async(e,r)=>{if(!e.useRhformZod)return!0;b.note("Setting up React Hook Form + Zod...","React Hook Form");let t=e.packageManager,a=e.useTypescript?"ts":"js",s=ee.join(r,"src"),o=["react-hook-form","zod","@hookform/resolvers"],n=t,p=["add",...o];if(t==="yarn"&&(n="yarn"),t==="bun"&&(n="bun"),!await y(`Installing React Hook Form & Zod using ${t}...`,"React Hook Form & Zod installed",async()=>(await be(n,p,{cwd:r}),!0),"Failed to install React Hook Form & Zod packages"))return!1;if(e.folderStructure==="simple"){let i=ee.join(s,`validations/index.${a}`);try{let m=e.useTypescript?`import { z } from "zod";
+
+// Example validation schema
+export const loginSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+  });
+
+export type LoginFormData = z.infer<typeof loginSchema>;
+
+// Add more validation schemas here
+`:`import { z } from "zod";
+
+// Example validation schema
+export const loginSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+  });
+
+// Add more validation schemas here
+`;await me.writeFile(i,m),b.log.success(`Created validations/index.${a}`)}catch(m){return b.log.error(`Failed to create validations: ${m.message}`),!1}}else{let i=ee.join(s,`features/auth/schema.${a}`);try{let m=e.useTypescript?`import { z } from "zod";
+
+// Auth feature validation schemas
+export const loginSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+  });
+
+export const registerSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+    confirmPassword: z.string(),
+  })
+  .refine((data) => data.password === data.confirmPassword, {
+    message: "Passwords don't match",
+    path: ["confirmPassword"],
+  });
+
+export type LoginFormData = z.infer<typeof loginSchema>;
+export type RegisterFormData = z.infer<typeof registerSchema>;
+
+// Add more validation schemas here
+`:`import { z } from "zod";
+
+// Auth feature validation schemas
+export const loginSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+  });
+
+export const registerSchema = z
+  .object({
+    email: z.string().email("Invalid email address"),
+    password: z.string().min(6, "Password must be at least 6 characters"),
+    confirmPassword: z.string(),
+  })
+  .refine((data) => data.password === data.confirmPassword, {
+    message: "Passwords don't match",
+    path: ["confirmPassword"],
+  });
+
+// Add more validation schemas here
+`;await me.writeFile(i,m),b.log.success(`Created features/auth/schema.${a}`)}catch(m){return b.log.error(`Failed to create schema: ${m.message}`),!1}}return!0};import{execa as de}from"execa";import*as x from"@clack/prompts";import U from"fs/promises";import D from"path";var re=async(e,r)=>{if(!e.useEslintPrettier)return!0;let t=e.packageManager,a=e.useTypescript,s=["eslint","eslint-plugin-react","eslint-plugin-react-hooks","eslint-plugin-jsx-a11y","eslint-plugin-import","eslint-config-prettier","eslint-plugin-prettier","prettier",...e.useTailwind?["prettier-plugin-tailwindcss"]:[]];a&&s.push("@typescript-eslint/eslint-plugin","@typescript-eslint/parser","typescript-eslint");let o=t,n;if(t==="npm"?n=["install","-D",...s]:t==="yarn"?n=["add","-D",...s]:t==="bun"?n=["add","-d",...s]:n=["add","-D",...s],!await y(`Installing ESLint + Prettier using ${t}...`,"ESLint & Prettier installed successfully",async()=>(await de(o,n,{cwd:r}),!0),"Failed to install ESLint/Prettier packages"))return!1;let u=D.join(r,"eslint.config.js"),l=a?`import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+import prettier from "eslint-plugin-prettier/recommended";
+import react from "eslint-plugin-react";
+import jsxA11y from "eslint-plugin-jsx-a11y";
+import { defineConfig, globalIgnores } from "eslint/config";
+
+export default defineConfig([
+  globalIgnores(["dist"]),
+  {
+    files: ["**/*.{ts,tsx}"],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+      prettier,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parser: tseslint.parser,
+      parserOptions: {
+        project: "./tsconfig.app.json",
+      },
+    },
+    plugins: {
+      react,
+      "jsx-a11y": jsxA11y,
+    },
+    settings: {
+      react: {
+        version: "detect",
+      },
+    },
+    rules: {
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+      "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "warn",
+      "jsx-a11y/alt-text": "warn",
+      "jsx-a11y/anchor-has-content": "warn",
+      "jsx-a11y/anchor-is-valid": "warn",
+    },
+  },
+]);
+`:`import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import prettier from "eslint-plugin-prettier/recommended";
+import react from "eslint-plugin-react";
+import jsxA11y from "eslint-plugin-jsx-a11y";
+import { defineConfig, globalIgnores } from "eslint/config";
+
+export default defineConfig([
+  globalIgnores(["dist"]),
+  {
+    files: ["**/*.{js,jsx}"],
+    extends: [js.configs.recommended, reactHooks.configs.flat.recommended, reactRefresh.configs.vite, prettier],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+    },
+    plugins: {
+      react,
+      "jsx-a11y": jsxA11y,
+    },
+    settings: {
+      react: {
+        version: "detect",
+      },
+    },
+    rules: {
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+      "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
+      "jsx-a11y/alt-text": "warn",
+      "jsx-a11y/anchor-has-content": "warn",
+      "jsx-a11y/anchor-is-valid": "warn",
+    },
+  },
+]);
+`;try{await U.writeFile(u,l),x.log.success("Created eslint.config.js")}catch(w){return x.log.error(`Failed to create ESLint config: ${w.message}`),!1}let i=D.join(r,".prettierrc"),m={semi:!0,singleQuote:!1,tabWidth:2,trailingComma:"es5",...e.useTailwind&&{plugins:["prettier-plugin-tailwindcss"]}};try{await U.writeFile(i,JSON.stringify(m,null,2)),x.log.success("Created .prettierrc")}catch(w){return x.log.error(`Failed to create Prettier config: ${w.message}`),!1}let h=D.join(r,".prettierignore"),C=`# Dependencies
+node_modules
+.pnpm-store
+
+# Build output
+dist
+build
+*.min.js
+*.min.css
+
+# Logs
+*.log
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Cache
+.cache
+*.cache
+
+# Public assets
+public
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lockb
+`;try{await U.writeFile(h,C),x.log.success("Created .prettierignore")}catch(w){return x.log.error(`Failed to create .prettierignore: ${w.message}`),!1}let d=D.join(r,"package.json");try{let w=await U.readFile(d,"utf-8"),B=JSON.parse(w);B.scripts={...B.scripts,lint:"eslint . --ext .ts,.tsx,.js,.jsx","lint:fix":"eslint . --ext .ts,.tsx,.js,.jsx --fix",format:"prettier --write .","format:check":"prettier --check ."},await U.writeFile(d,JSON.stringify(B,null,2)),x.log.success("Added lint and format scripts to package.json")}catch(w){return x.log.error(`Failed to update package.json: ${w.message}`),!1}let k=["globals"],$;t==="npm"?$=["install","-D",...k]:t==="yarn"?$=["add","-D",...k]:t==="bun"?$=["add","-d",...k]:$=["add","-D",...k];try{await de(o,$,{cwd:r}),x.log.success("Installed ESLint peer dependencies")}catch(w){x.log.warn(`Could not install peer dependencies: ${w.message}`)}return!0};import{execa as Fe}from"execa";import*as S from"@clack/prompts";import V from"fs/promises";import E from"path";var fe=e=>{let r=e.useTypescript,t=e.useRedux,a=e.useReactQueryAxios,s=e.useRouter,o=e.folderStructure==="simple",n=[];t&&(n.push('import { Provider } from "react-redux"'),n.push(`import { store } from "${o?"../store":"./store"}"`)),a&&(n.push('import { QueryClientProvider } from "@tanstack/react-query"'),n.push(`import { queryClient } from "${o?"../lib/queryClient":"../shared/lib/queryClient"}"`)),s&&(n.push('import { RouterProvider } from "react-router"'),n.push(`import { router } from "${o?"../routes":"./router"}"`)),!s&&r&&n.push('import type { ReactNode } from "react"');let p=i=>{let m=i;return a&&(m=`<QueryClientProvider client={queryClient}>
+${m}</QueryClientProvider>`),t&&(m=`<Provider store={store}>
+${m}</Provider>`),m},u=s?"    <RouterProvider router={router} />":"    {children}",l=s?"":r?"{ children }: { children: ReactNode }":"{ children }";return`${n.join(`
+`)}
+
+const Providers = (${l}) => {
+  return (
+${p(u)}
+  );
+};
+
+export default Providers;
+`},ge=e=>{let r=e.folderStructure==="simple",t=e.useRouter;return`import Providers from ${r?'"./components/providers"':'"./app/providers"'};
+
+const App = () => {
+  return ${t?"<Providers />":"<Providers><div>App</div></Providers>"};
+};
+
+export default App;
+`},he=e=>`import { createBrowserRouter } from "react-router";
+
+export const router = createBrowserRouter([
+  {
+    path: "/",
+    element: <div>Home</div>,
+    children: [
+      // Add your routes here
+    ],
+  },
+]);
+`,ye=e=>`import AuthLayout from "./layout";
+
+export const authRoutes = [
+  {
+    path: "auth",
+    element: <AuthLayout />,
+    children: [
+      {
+        path: "login",
+        element: <div>Login</div>,
+      },
+      {
+        path: "register",
+        element: <div>Register</div>,
+      },
+    ],
+  },
+];
+`,we=e=>`import { createBrowserRouter } from "react-router";
+import { authRoutes } from "../features/auth/routes";
+
+export const router = createBrowserRouter([
+  {
+    path: "/",
+    element: <div>Home</div>,
+  },
+  ...authRoutes,
+]);
+`,se=e=>`// Global type definitions
+
+// Example: User type
+export interface User {
+  id: string;
+  email: string;
+  name: string;
+}
+
+// Example: API response type
+export interface ApiResponse<T> {
+  data: T;
+  message: string;
+  success: boolean;
+}
+
+// Add more global types here
+`,ke=e=>`// Auth feature types
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  name: string;
+}
+
+export interface LoginCredentials {
+  email: string;
+  password: string;
+}
+
+export interface RegisterCredentials extends LoginCredentials {
+  confirmPassword: string;
+}
+
+// Add more auth-related types here
+`,xe=e=>{let r=e.useTypescript;return e.useReactQueryAxios?`// Auth feature API calls using Axios
+${r?`import type { AuthUser, LoginCredentials, RegisterCredentials } from "./types";
+import type { ApiResponse } from "../../shared/types";
+import { api } from "../../shared/lib/api";`:'import { api } from "../shared/lib/api";'}
+
+// Example API functions
+export const login = async (credentials${r?": LoginCredentials":""})${r?": Promise<ApiResponse<AuthUser>>":""} => {
+  const { data } = await api.post("/auth/login", credentials);
+  return data;
+};
+
+export const register = async (credentials${r?": RegisterCredentials":""})${r?": Promise<ApiResponse<AuthUser>>":""} => {
+  const { data } = await api.post("/auth/register", credentials);
+  return data;
+};
+
+// Add more API functions here
+`:`// Auth feature API calls using Fetch
+${r?`import type { AuthUser, LoginCredentials, RegisterCredentials } from "./types";
+import type { ApiResponse } from "../shared/types";`:""}
+
+// Example API functions
+export const login = async (credentials${r?": LoginCredentials":""})${r?": Promise<ApiResponse<AuthUser>>":""} => {
+  // Implement login API call
+  const response = await fetch("/api/auth/login", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(credentials),
+  });
+  return response.json();
+};
+
+export const register = async (credentials${r?": RegisterCredentials":""})${r?": Promise<ApiResponse<AuthUser>>":""} => {
+  // Implement register API call
+  const response = await fetch("/api/auth/register", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(credentials),
+  });
+  return response.json();
+};
+
+// Add more API functions here
+`},J=e=>`import { Outlet } from "react-router";
+
+const AuthLayout = () => {
+  return (
+    <div>
+      Auth Layout
+      <Outlet />
+    </div>
+  );
+};
+
+export default AuthLayout;
+`;var ae=async(e,r)=>{if(!e.useRouter)return!0;S.note("Setting up React Router...","React Router");let t=e.packageManager,a=e.useTypescript?"tsx":"jsx",s=E.join(r,"src"),o=["react-router"],n=t,p=["add",...o];if(t==="npm"?p=["install",...o]:t==="yarn"?p=["add",...o]:t==="bun"&&(p=["add",...o]),!await y(`Installing React Router using ${t}...`,"React Router installed",async()=>(await Fe(n,p,{cwd:r}),!0),"Failed to install React Router"))return!1;let l=e.folderStructure==="simple";try{if(l){let i=E.join(s,"routes");await V.mkdir(i,{recursive:!0});let m=E.join(i,`index.${a}`);await V.writeFile(m,he(e)),S.log.success(`Created routes/index.${a}`)}else{let i=E.join(s,`app/router.${a}`);await V.writeFile(i,we(e)),S.log.success(`Created app/router.${a}`);let m=E.join(s,`features/auth/routes.${a}`);await V.writeFile(m,ye(e)),S.log.success(`Created features/auth/routes.${a}`);let h=E.join(s,`features/auth/layout.${a}`);await V.writeFile(h,J(e)),S.log.success(`Created features/auth/layout.${a}`)}return S.log.success("React Router setup complete!"),!0}catch(i){return S.log.error(`Failed to create router files: ${i.message}`),!1}};var Ce=async(e,r)=>await Ee(e,r)?(f.note("Next steps (dependencies, Tailwind, etc.) will be added gradually."),await W(e,r)?await G(e,r)?await K(e,r)?await ae(e,r)?await Y(e,r)?await X(e,r)?await te(e,r)?await re(e,r)?await Ie(e,r)?!0:(f.log.error("Failed to generate application files."),!1):(f.log.error("Failed to setup ESLint & Prettier."),!1):(f.log.error("Failed to setup react hook form & zod."),!1):(f.log.error("Failed to setup react query & axios."),!1):(f.log.error("Failed to setup redux toolkit."),!1):(f.log.error("Failed to setup React Router."),!1):(f.log.error("Failed to setup folder structure."),!1):(f.log.error("Failed to setup React Compiler. Aborting."),!1):(f.log.error("Failed to setup Tailwind. Aborting."),!1)):(f.log.error("Failed to create Vite project. Aborting."),!1),Ee=async(e,r)=>{let t=e.useTypescript?"react-ts":"react",a=e.packageManager,s,o;return a==="npm"?(s="npm",o=["create","vite@latest",".","--","--template",t,"--no-interactive"]):a==="yarn"?(s="yarn",o=["create","vite",".","--template",t,"--no-interactive"]):a==="bun"?(s="bun",o=["create","vite",".","--template",t,"--no-interactive"]):(s="pnpm",o=["create","vite@latest",".","--template",t,"--no-interactive","--"]),await y(`Creating Vite project using ${a}...`,"Vite project created successfully! \u{1F389}",async()=>{let n=await Te(s,o,{cwd:r,stdio:"pipe"});return n.stderr&&f.log.warn(`Warnings/Logs: ${n.stderr}`),f.log.message(n.stdout||"Done."),!0},"Failed to create Vite project").catch(n=>(f.log.error(`Error details: ${n.message}`),!1))},Ie=async(e,r)=>{f.note("Generating application files...","Files");let t=e.useTypescript?"ts":"js",a=e.useTypescript?"tsx":"jsx",s=R.join(r,"src"),o=e.folderStructure==="simple";try{let n=R.join(s,`App.${a}`);await P.writeFile(n,ge(e)),f.log.success(`Created App.${a}`);let p=o?R.join(s,`components/providers.${a}`):R.join(s,`app/providers.${a}`);if(await P.writeFile(p,fe(e)),f.log.success(`Created ${o?"components":"app"}/providers.${a}`),e.useTypescript)if(o){let u=R.join(s,"types/index.d.ts");await P.writeFile(u,se(e)),f.log.success("Created types/index.d.ts")}else{let u=R.join(s,"shared/types/index.d.ts");await P.writeFile(u,se(e)),f.log.success("Created shared/types/index.d.ts");let l=R.join(s,"features/auth/types.d.ts");await P.writeFile(l,ke(e)),f.log.success("Created features/auth/types.d.ts")}if(!o){let u=R.join(s,`features/auth/api.${t}`);await P.writeFile(u,xe(e)),f.log.success(`Created features/auth/api.${t}`);let l=R.join(s,`features/auth/layout.${a}`);await P.writeFile(l,J(e)),f.log.success(`Created features/auth/layout.${a}`);let i=R.join(s,`shared/api.${t}`),m=e.useReactQueryAxios?`// Re-export API from lib location | OR can add shared api calls here
+export { api } from "./lib/api";
+`:`// Shared API configuration
+export const api = {
+  // Add your shared API configuration here
+};
+`;await P.writeFile(i,m),f.log.success(`Created shared/api.${t}`)}return f.log.success("Application files generated successfully!"),!0}catch(n){return f.log.error(`Failed to generate application files: ${n.message}`),!1}};console.log(oe.bold("crvp CLI v0.1.0"));Re.name("crvp").description("Interactive CLI to create modern React + Vite projects").version("0.1.0").argument("[project-name]","Name of the project (folder)").action(async e=>{let t=await _(e);if(t){ie.log.step("Preparing project directory...");let a=await ne(t.projectName);if(!a){console.log(oe.yellow("Project creation cancelled."));return}a&&t&&(await Ce(t,a)||process.exit(1)),ie.log.success(`Ready to scaffold in: ${oe.cyan(a)}`)}});Re.parse();

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "create-rvp",
+  "version": "1.0.0",
+  "description": "Interactive CLI for creating modern React + Vite projects with shadcn, Tailwind, Redux, etc.",
+  "type": "module",
+  "main": "dist/cli.js",
+  "author": "Mostafa Khaled",
+  "keywords": [
+    "cli",
+    "vite",
+    "react",
+    "create",
+    "scaffold",
+    "tailwind"
+  ],
+  "bin": {
+    "create-rvp": "bin/index.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "build": "tsup src/cli.ts --format esm --clean --minify",
+    "lint": "eslint . --ext .ts"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "commander": "^14.0.3",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.3",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
+    "eslint": "^10.0.2",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}