{"id":30220973,"url":"https://github.com/chihebnabil/lovable-boilerplate","last_synced_at":"2025-08-14T09:47:19.657Z","repository":{"id":305566850,"uuid":"1023215238","full_name":"chihebnabil/lovable-boilerplate","owner":"chihebnabil","description":"A Lovable-inspired React boilerplate that brings no-code AI UI generation into clean code. Fully open, customizable, and structured to work seamlessly with GitHub Copilot","archived":false,"fork":false,"pushed_at":"2025-07-27T22:14:33.000Z","size":272,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-27T23:29:39.894Z","etag":null,"topics":["boilerplate","copilot","lovable","lovable-dev","react"],"latest_commit_sha":null,"homepage":"https://nextlovable.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chihebnabil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-20T19:07:33.000Z","updated_at":"2025-07-27T22:14:36.000Z","dependencies_parsed_at":"2025-07-20T21:33:18.998Z","dependency_job_id":null,"html_url":"https://github.com/chihebnabil/lovable-boilerplate","commit_stats":null,"previous_names":["chihebnabil/lovable-boilerplate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chihebnabil/lovable-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chihebnabil%2Flovable-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chihebnabil%2Flovable-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chihebnabil%2Flovable-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chihebnabil%2Flovable-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chihebnabil","download_url":"https://codeload.github.com/chihebnabil/lovable-boilerplate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chihebnabil%2Flovable-boilerplate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270399761,"owners_count":24577107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-14T02:00:10.309Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","copilot","lovable","lovable-dev","react"],"created_at":"2025-08-14T09:47:17.581Z","updated_at":"2025-08-14T09:47:19.614Z","avatar_url":"https://github.com/chihebnabil.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lovable Boilerplate\n\n\u003e **Reverse-engineered Lovable AI app builder** turned into a developer-friendly React boilerplate with comprehensive AI coding assistant instructions.\n\n[![React](https://img.shields.io/badge/React-18.3.1-blue.svg)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5.3-blue.svg)](https://www.typescriptlang.org/)\n[![Vite](https://img.shields.io/badge/Vite-5.4.1-purple.svg)](https://vitejs.dev/)\n[![shadcn/ui](https://img.shields.io/badge/shadcn%2Fui-components-black.svg)](https://ui.shadcn.com/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.4.11-cyan.svg)](https://tailwindcss.com/)\n\n## One-Click Setup\n[![Edit with Bolt](https://img.shields.io/badge/Edit%20with-Bolt-4285F4?style=for-the-badge\u0026logo=stackblitz\u0026logoColor=white)](https://bolt.new/~/github.com/chihebnabil/lovable-boilerplate)\n[![Edit with Replit](https://img.shields.io/badge/Edit%20with-Replit-4285F4?style=for-the-badge\u0026logo=replit\u0026logoColor=white)](https://replit.com/@ChihebNabil/lovable-boilerplate)\n## What is this?\n\nThis boilerplate **reverse-engineers** the magic behind [Lovable's](https://lovable.dev) no-code AI app builder into a traditional React codebase that developers can understand, modify, and extend. It bridges the gap between no-code AI generation and developer control.\n\n\u003e **💡 Built something with Lovable or using this boilerplate?**  \n\u003e Upgrade to a fullstack Next.js app in minutes with [**NextLovable.com**](https://nextlovable.com/)  \n\u003e Get production-ready performance, better SEO, and full control.\n\n\n\n## Tech Stack\n\n| Technology | Purpose | Version |\n|------------|---------|---------|\n| **React** | UI Library | 18.3.1 |\n| **TypeScript** | Type Safety | 5.5.3 |\n| **Vite** | Build Tool | 5.4.1 |\n| **shadcn/ui** | Component Library | Latest |\n| **Tailwind CSS** | Styling | 3.4.11 |\n| **React Router** | Navigation | 6.26.2 |\n| **TanStack Query** | Data Fetching | 5.56.2 |\n| **React Hook Form** | Form Handling | 7.53.0 |\n| **Zod** | Schema Validation | 3.23.8 |\n\n\n\n### Prerequisites\n- Node.js 18+ or Bun\n- Git\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/chihebnabil/lovable-boilerplate.git\ncd lovable-boilerplate\n\n# Install dependencies (npm, yarn, or bun)\nnpm install\n# or\nbun install\n\n# Start development server\nnpm run dev\n# or\nbun dev\n```\n\nYour app will be running at `http://localhost:8080`\n\n## AI Coding Assistant Instructions\n\nThis boilerplate is **optimized for AI coding assistants** like GitHub Copilot and Cursor. All comprehensive instructions are located in:\n\n**`.github/instructions/global.instructions.md`**\n\nThese instructions include:\n- **Modern Design Guidelines** - Create premium, contemporary interfaces\n- **Architecture Patterns** - Project structure and best practices  \n- **Component Usage** - How to use shadcn/ui components effectively\n- **Development Workflow** - Adding features, pages, and functionality\n- **Styling System** - Color palettes, spacing, typography, and animations\n- **Responsive Design** - Mobile-first development principles\n\n### For AI Assistants (Copilot/Cursor users):\nSimply reference the instructions file when working on this project. The AI will understand the project structure, styling guidelines, and development patterns automatically.\n\n## Project Structure\n\n```\nlovable-boilerplate/\n├── .github/\n│   └── instructions/           # AI coding assistant instructions\n│       └── global.instructions.md\n├── src/\n│   ├── components/ui/          # shadcn/ui components (40+ pre-built)\n│   ├── hooks/                  # Custom React hooks\n│   ├── lib/                    # Utility functions\n│   ├── pages/                  # Route components\n│   │   ├── Index.tsx           # Home page (/)\n│   │   └── NotFound.tsx        # 404 page\n│   ├── App.tsx                 # Main app with routing\n│   ├── main.tsx                # Entry point\n│   └── index.css               # Global styles\n├── public/                     # Static assets\n├── package.json                # Dependencies\n├── vite.config.ts              # Vite configuration  \n├── tailwind.config.ts          # Tailwind configuration\n├── components.json             # shadcn/ui configuration\n└── tsconfig.json               # TypeScript configuration\n```\n\n## Available Components\n\n### UI Components (40+ ready-to-use)\nAll components are pre-configured with shadcn/ui and located in `src/components/ui/`:\n\n**Layout \u0026 Navigation**\n- `accordion`, `card`, `separator`, `sheet`, `sidebar`, `tabs`\n- `breadcrumb`, `command`, `dropdown-menu`, `menubar`, `navigation-menu`, `pagination`\n\n**Forms \u0026 Inputs** \n- `button`, `input`, `textarea`, `select`, `checkbox`, `radio-group`, `switch`, `form`\n- `calendar`, `input-otp`, `slider`, `toggle`\n\n**Feedback \u0026 Overlays**\n- `alert`, `alert-dialog`, `toast`, `sonner`, `progress`, `skeleton`\n- `dialog`, `drawer`, `hover-card`, `popover`, `tooltip`\n\n**Data Display**\n- `avatar`, `badge`, `table`, `chart`, `carousel`\n- `aspect-ratio`, `collapsible`, `resizable`, `scroll-area`\n\n\n### Layout Principles\n- **Generous Spacing**: `py-16 lg:py-24` for sections\n- **Consistent Rhythm**: `space-y-4 lg:space-y-6` for content\n- **Responsive First**: Mobile-first responsive design\n- **Typography Scale**: Hierarchical text sizing\n\n## Development Commands\n\n```bash\n# Development\nnpm run dev          # Start dev server (port 8080)\nnpm run build        # Production build  \nnpm run build:dev    # Development build\nnpm run preview      # Preview production build\nnpm run lint         # Run ESLint\n\n# Using Bun (faster alternative)\nbun dev             # Start dev server\nbun run build       # Production build\n```\n\n\n## What Makes This Special?\n\n1. **Reverse-Engineered**: Based on patterns from Lovable's AI app builder\n2. **AI-Optimized**: Designed specifically for AI coding assistants\n3. **Design-First**: Premium visual design out of the box\n4. **Performance**: Lightning-fast development and build times\n5. **Flexible**: Easy to customize and extend\n6. **Modern**: Latest React patterns and best practices\n\n## Contributing\n\nWe welcome contributions! This project aims to provide the best possible starting point for AI-assisted React development.\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nMIT License - feel free to use this for any project!\n\n## Acknowledgments\n\n- **Lovable.dev** - Inspiration for the AI-first development approach\n- **shadcn/ui** - Excellent component library and design system\n- **Vercel** - Amazing tooling ecosystem (React, Vite, etc.)\n- **Tailwind Labs** - Revolutionary CSS framework\n\n**Happy coding!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchihebnabil%2Flovable-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchihebnabil%2Flovable-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchihebnabil%2Flovable-boilerplate/lists"}