Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-smart-starter) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

React Smart Starter

npm version npm downloads

🚀 A modern React + Vite + Tailwind starter CLI designed to help developers kickstart projects quickly with preconfigured routes, authentication, context management, and reusable UI components.

Fully responsive and customizable, it includes a dashboard layout, login/signup flow, OTP verification, and a clean design inspired by ShadCN.

✨ Features

✅ Routing with React Router v6
✅ Authentication: Login, Signup, OTP, Forgot/Reset Password
✅ Dashboard layout with Sidebar, Header, and responsive content area
✅ Reusable components: Navbar, Footer, Cards, Buttons
✅ Responsive design using TailwindCSS
✅ Customizable color theme
✅ 404 Not Found page

📦 Prerequisites

Node.js >= 16
npm >= 7 (or yarn/pnpm)

🚀 Installation

Create a new project in seconds:

Run with npx:

npx react-smart-starter my-app
cd my-app
npm install
npm run dev

Or with npm init:

npm init react-smart-starter my-app

📂 Project Structure

src/
├─ components/       # Reusable components (Header, Footer, etc.)
├─ layouts/          # MainLayout, DashboardLayout, ProtectedRoute
├─ pages/            # Home, Signup, Login, Dashboard, OTP, Forgot/Reset
├─ contexts/         # AuthContext for authentication state
├─ hooks/            # Custom hooks
└─ main.jsx          # Router setup

⚡ Usage

Public pages: Home, Signup, Login, OTP, Forgot/Reset Password
Protected pages: Dashboard (accessible only when logged in)

Example: adding a new dashboard route

{
  path: "users",
  element: <UsersPage />
}

🎨 Customize colors and fonts in tailwind.config.js.

📸 Screenshots / Demo

After running:

npx react-smart-starter my-app

You'll instantly get a project with authentication, dashboard, and Tailwind preconfigured 👇

Starter Preview

🌍 Live Demo

👉 Coming soon on Vercel!

🤝 Contributing

Fork the repository
Create a new branch (git checkout -b feature/new-feature)
Make your changes
Submit a Pull Request

📜 License

This project is licensed under the MIT License.

👤 Author

Ayotech – Portfolio