{"id":28272652,"url":"https://github.com/jjcall/vibeship-boilerplate","last_synced_at":"2026-04-10T17:03:13.095Z","repository":{"id":293951167,"uuid":"985581335","full_name":"jjcall/vibeship-boilerplate","owner":"jjcall","description":"A vibe  friendly Next.js starter template with Tailwind, shadcn/ui, Supabase, Stripe, and AI tooling—built for shipping real projects fast without overthinking your stack.","archived":false,"fork":false,"pushed_at":"2025-05-19T05:53:06.000Z","size":113,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-27T14:39:15.097Z","etag":null,"topics":["boilerplate","nextjs","react","shadcn","stripe","supabase","vibe-coding"],"latest_commit_sha":null,"homepage":"","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/jjcall.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-05-18T04:34:20.000Z","updated_at":"2025-05-19T21:02:16.000Z","dependencies_parsed_at":"2025-05-18T20:31:00.970Z","dependency_job_id":null,"html_url":"https://github.com/jjcall/vibeship-boilerplate","commit_stats":null,"previous_names":["jjcall/ship-fast52","jjcall/next-fast52","jjcall/vibeship-boilerplate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jjcall/vibeship-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjcall%2Fvibeship-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjcall%2Fvibeship-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjcall%2Fvibeship-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjcall%2Fvibeship-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jjcall","download_url":"https://codeload.github.com/jjcall/vibeship-boilerplate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjcall%2Fvibeship-boilerplate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260442593,"owners_count":23009871,"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","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","nextjs","react","shadcn","stripe","supabase","vibe-coding"],"created_at":"2025-05-21T00:16:08.004Z","updated_at":"2025-12-30T23:04:41.971Z","avatar_url":"https://github.com/jjcall.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 VibeShip Boilerplate\n\nA **vibe friendly starter template** for building full-stack web apps with **Next.js 15**, **Tailwind CSS**, and all the essentials for shipping fast.\n\nUse this when you want to **start building real projects** without overthinking your stack.\n\n---\n\n## ✅ What's Included\n\n- **[Next.js 15](https://nextjs.org)** (App Router + TypeScript) — Production-ready framework with React 19.\n- **[Tailwind CSS](https://tailwindcss.com)** — Utility-first styling that works with your custom designs.\n- **[shadcn/ui](https://ui.shadcn.com)** — Pre-wired headless components (buttons, dialogs, etc.) ready for your styles.\n- **[Framer Motion](https://www.framer.com/motion/)** — For clean, simple animations.\n- **[Supabase](https://supabase.com)** — Auth and database client ready to connect to your project.\n- **[Resend](https://resend.com)** — Pre-wired email utility for sending transactional emails.\n- **AI Clients** — [OpenAI](https://openai.com), [Anthropic](https://anthropic.com)\n\n---\n\n## 🛠️ Getting Started\n\n1. **Clone This Template**\n\n```bash\ngit clone https://github.com/jjcall/vibeship-boilerplate.git my-app\ncd my-app\n```\n\n2. **Install Dependencies**\n\n```bash\nnpm install\n```\n\n3. **Start Your Dev Server**\n\n```bash\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser.\n\n---\n\n## ⚙️ Environment Setup\n\nCopy the example env file and add your keys:\n\n```bash\ncp .env.example .env.local\n```\n\nFill in the environment variables your project will require:\n\n```\nNEXT_PUBLIC_SUPABASE_URL=\nNEXT_PUBLIC_SUPABASE_ANON_KEY=\nNEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=\nOPENAI_API_KEY=\nANTHROPIC_API_KEY=\nRESEND_API_KEY=\n```\n\n---\n\n## 🧱 Ready to Build\n\nYou'll find example files already set up to help you get started:\n\n- **\\`src/components/\\`** — Your reusable components (pre-wired with shadcn/ui).\n- **\\`src/lib/\\`** — API clients for Supabase, Stripe, and AI providers.\n- **\\`src/app/api/send-email/route.ts\\`** — Example email API you can extend.\n- **\\`src/app/layout.tsx\\`** — Your global layout and styles.\n- **\\`src/app/page.tsx\\`** — Your homepage.\n\nUse these as a launchpad, delete what you don't need, and make it your own.\n\n---\n\n## 📝 VibeShip Cursor Rules\n\nThis project includes **predefined Cursor rules** to help you get the most out of **AI-assisted development**. These rules where heavily inspired by [@aashari](https://github.com/aashari) and their [00 - Cursor AI Prompting Rules.md](https://gist.github.com/aashari/07cc9c1b6c0debbeb4f4d94a3a81339e) gist.\n\n### Available Cursor Rule Files\n\n- `.cursor/rules/always-on.mdc`\n  Persistent base rules applied to all AI actions. Defines project structure, style, and behavior.\n\n- `.cursor/rules/request.mdc`\n  Use when you want AI to build a new feature, refactor existing code, or make specific improvements.\n\n- `.cursor/rules/diagnose.mdc`\n  Use when you want AI to re-examine or fix an issue that wasn’t fully resolved previously.\n\n\n---\n\n### How to Use\n\n1. **Make sure Cursor is installed and running in your editor.**\n2. **Pick the Right Rule for Your Intent:**\n   - **General AI Help**: _No action needed_, `always-on.mdc` applies automatically.\n   - **New Features / Refactoring**: tag `@request` to guide AI behavior for building or improving code.\n   - **Debugging / Issue Diagnosis**: tag `@diagnose` to guide AI in re-analyzing and resolving issues.\n3. **Interact with Cursor as you normally would.**\n   The rule context helps Cursor provide **more relevant and consistent outputs** based on your project’s standards.\n\n---\n\n### Why This Matters\n\nBy using these pre-written rule files, you ensure that:\n- AI follows your **project structure and coding conventions**.\n- AI applies **consistent problem-solving methods**.\n- You get **higher quality, more reliable** results from AI-powered suggestions.\n\nThese rules make AI feel more like a **pair programming partner who actually knows your project**.\n\n---\n\n## 📐 Project Conventions\n\nThis project follows a consistent structure to keep development clean and efficient:\n\n### 📁 File Organization\n- `src/components/ui/` — Low-level UI components (shadcn/ui)\n- `src/components/sections/` — Custom page sections (Hero, Pricing, etc.)\n- `src/components/layout/` — Layout components (Navbar, Footer)\n- `src/lib/` — API clients and helpers\n- `src/app/` — Pages and routes\n\n### 🎨 Development Guidelines\n- TypeScript for all files\n- Tailwind CSS for styling (using theme tokens)\n- ES Modules for imports/exports\n- Framer Motion for animations\n- API clients from `src/lib/` (Supabase, Stripe, AI)\n\n### ⚡ Core Principles\n- Simplicity over perfection\n- Ship fast, iterate often\n- Easy to extend and maintain\n- Clean, readable code over clever solutions\n\n---\n\n## 🧑‍💻 Start Building\n\nThere's no right or wrong way to start.\nGrab a component, design a page, hit an API, or build a flow.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjcall%2Fvibeship-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjjcall%2Fvibeship-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjcall%2Fvibeship-boilerplate/lists"}