|
1 | 1 | # 🏬 relivator next.js ecommerce starter
|
2 | 2 |
|
3 |
| -> - **Relivator is a robust, production-ready eCommerce template built with Next.js and other modern technologies.** |
4 |
| -> - **It's designed for developers who want a fast, modern, and scalable foundation without reinventing the backend.** |
5 |
| -> - _🤖 Want to discuss this repo with AI? Reliverse will be happy to chat with you! [💬 Talk here](https://reliverse.org/projects/blefnk/relivator-nextjs-template?chat=true)._ |
6 |
| -<!-- > - 🎧 _Prefer listening than reading?_ Reliverse Deep Dive on Relivator is live! [▶️ Listen here](./docs/podcast-relivator.mp3). --> |
7 |
| -
|
8 |
| ---- |
9 |
| - |
10 |
| -<div align="left"> |
11 |
| - <a alt="GitHub license" href="https://github.com/blefnk/relivator/blob/main/LICENSE"> |
12 |
| - <picture> |
13 |
| - <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/license/blefnk/relivator?style=flat-square&labelColor=32363B&color=ffffff"> |
14 |
| - <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/license/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
15 |
| - <img alt="relivator license" src="https://img.shields.io/github/license/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
16 |
| - </picture> |
17 |
| - </a> |
18 |
| - <a alt="GitHub issues" href="https://github.com/blefnk/relivator/issues"> |
19 |
| - <picture> |
20 |
| - <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/issues/blefnk/relivator?style=flat-square&labelColor=32363B&color=ffffff"> |
21 |
| - <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/issues/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
22 |
| - <img alt="relivator issues" src="https://img.shields.io/github/issues/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
23 |
| - </picture> |
24 |
| - </a> |
25 |
| - <a alt="GitHub repo stars" href="https://github.com/blefnk/relivator/stargazers"> |
26 |
| - <picture> |
27 |
| - <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/stars/blefnk/relivator?style=flat-square&labelColor=32363B&color=ffffff"> |
28 |
| - <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/stars/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
29 |
| - <img alt="relivator stars" src="https://img.shields.io/github/stars/blefnk/relivator?style=flat-square&labelColor=EBEEF2&color=000000"> |
30 |
| - </picture> |
31 |
| - </a> |
32 |
| -</div> |
33 |
| - |
34 |
| ---- |
35 |
| - |
36 |
| -[Demo](https://relivator.com) — [Sponsor](https://github.com/sponsors/blefnk) — [Discord](https://discord.gg/Pb8uKbwpsJ) — [GitHub](https://github.com/blefnk/relivator) — [Docs](https://deepwiki.com/blefnk/relivator-nextjs-template) — [Introduction](https://blefnk.reliverse.org/my-projects/relivator) |
37 |
| - |
38 |
| -## Features |
39 |
| - |
40 |
| -The following features are the main Reliverse's stack. You can check the Versator to see Reliverse's another stack variant with Clerk, Stripe, Motion, and more. |
41 |
| - |
42 |
| -- ⚡ **Framework:** Next.js 15.3 • React 19.1 • TypeScript 5.8 |
43 |
| -- 🔐 **Auth:** First-class authentication with [Better Auth](https://better-auth.com) |
44 |
| -- 🗄️ **Database:** Typed PostgreSQL via [Drizzle ORM](https://orm.drizzle.team) & [Neon](https://neon.tech) |
45 |
| -- 📄 **Forms:** Powered by schema-ready [TanStack Form](https://tanstack.com/form) _(🏗️ W.I.P)_ |
46 |
| -- 📄 **Typesafe APIs:** Typed by [oRPC](https://orpc.unnoq.com) _(🏗️ W.I.P)_ |
47 |
| -- 💳 **Payments:** Integration with [Polar](https://polar.sh) _(🏗️ W.I.P)_ |
48 |
| -- 📦 **Storage:** Smooth file uploads via [Uploadthing](https://uploadthing.com) |
49 |
| -- 🎨 **Styling:** [shadcn/ui](https://ui.shadcn.com) with Tailwind CSS 4.1 |
50 |
| -- 🦄 **Animations:** Built-in [Anime.js](https://animejs.com) with a sample banner |
51 |
| -- 📊 **Analytics:** Built-in optional [Vercel Analytics](https://vercel.com/docs/analytics) |
52 |
| -- 🛠️ **DX Tools:** Preconfigured ESLint 9, [Biome](https://biomejs.dev), [Knip](https://knip.dev) |
53 |
| - |
54 |
| -## Quick Start |
55 |
| - |
56 |
| -To get started: |
57 |
| - |
58 |
| -1. Install [Git](https://git-scm.com), [Node.js](https://nodejs.org), and [Bun](https://bun.sh). |
59 |
| -2. Run: |
| 3 | +[demo](https://relivator.com) — [sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/Pb8uKbwpsJ) — [github](https://github.com/blefnk/relivator) — [docs](https://deepwiki.com/blefnk/relivator-nextjs-template) |
| 4 | + |
| 5 | +> relivator is a robust ecommerce template built with next.js and other modern technologies. it's designed for developers who want a fast, modern, and scalable foundation without reinventing the backend. |
| 6 | +
|
| 7 | +## features |
| 8 | + |
| 9 | +- ⚡ **framework:** next.js 15.3 + react 19.1 + ts 5.8 |
| 10 | +- 🔐 **auth:** [better-auth](https://better-auth.com) |
| 11 | +- 🗄️ **db:** pg + [drizzle-orm](https://orm.drizzle.team) |
| 12 | +- 📦 **storage:** [uploadthing](https://uploadthing.com) |
| 13 | +- 🎨 **styling:** tailwind 4.1 + [shadcn](https://ui.shadcn.com) |
| 14 | +- 🦄 **animations:** [anime.js](https://animejs.com) |
| 15 | +- 📊 **analytics:** [vercel](https://vercel.com/docs/analytics) |
| 16 | +- 🛠️ **dx tools:** eslint + [biome](https://biomejs.dev) + [knip](https://knip.dev) |
| 17 | +- 💳 **payments:** [polar](https://polar.sh) _(🏗️ w.i.p)_ |
| 18 | +- 🧬 **api:** next + [orpc](https://orpc.unnoq.com) _(🏗️ w.i.p)_ |
| 19 | +- 📄 **forms:** [tanstack](https://tanstack.com/form) _(🏗️ w.i.p)_ |
| 20 | + |
| 21 | +> these features define the standard reliverse stack. for an alternative setup—featuring clerk, stripe, trpc, and more—check out [versator](https://github.com/blefnk/versator). |
| 22 | +
|
| 23 | +## quick start |
| 24 | + |
| 25 | +1. install [git](https://git-scm.com), [node.js](https://nodejs.org), [bun](https://bun.sh). |
| 26 | +2. run: |
60 | 27 |
|
61 | 28 | ```bash
|
62 | 29 | git clone https://github.com/blefnk/relivator.git
|
63 | 30 | cd relivator
|
64 |
| - bun install |
| 31 | + bun i |
65 | 32 | copy .env.example .env
|
66 | 33 | ```
|
67 | 34 |
|
68 |
| -3. Fill in the required environment variables in the `.env` file. |
69 |
| -4. Run: |
| 35 | +3. fill in the required environment variables in the `.env` file. |
| 36 | +4. run: |
70 | 37 |
|
71 | 38 | ```bash
|
72 |
| - bun dev # Start development server |
73 |
| - bun run build # Build production version |
| 39 | + bun dev # start development server |
| 40 | + bun run build # build production version |
74 | 41 | ```
|
75 | 42 |
|
76 |
| -5. Edit something in the code manually or ask AI to help you. |
77 |
| -6. Done. Seriously. You're building now. |
| 43 | +5. edit something in the code manually or ask ai to help you. |
| 44 | +6. done. seriously. you're building now. |
78 | 45 |
|
79 | 46 | <!--
|
80 |
| -2. Run: |
| 47 | +2. run: |
81 | 48 | ```bash
|
82 | 49 | bun i -g @reliverse/cli
|
83 | 50 | reliverse cli
|
84 | 51 | ```
|
85 |
| -3. Select **"Create a new project"**. |
86 |
| -4. Follow prompts to configure your store. |
| 52 | +3. select **"create a new project"**. |
| 53 | +4. follow prompts to configure your store. |
87 | 54 | -->
|
88 | 55 |
|
89 |
| -### Commands |
| 56 | +### commands |
90 | 57 |
|
91 |
| -| Command | Description | |
| 58 | +| command | description | |
92 | 59 | |-----------------|--------------------------------|
|
93 |
| -| `bun dev` | Start local development | |
94 |
| -| `bun build` | Create a production build | |
95 |
| -| `bun latest` | Sync all dependencies | |
96 |
| -| `bun ui` | Add UI components | |
97 |
| -| `bun db:push` | Apply DB schema changes | |
98 |
| -| `bun db:auth` | Update auth-related tables | |
99 |
| -| `bun db:studio` | Open visual DB editor | |
100 |
| - |
101 |
| -## Notes |
| 60 | +| `bun dev` | start local development | |
| 61 | +| `bun build` | create a production build | |
| 62 | +| `bun latest` | install latest deps | |
| 63 | +| `bun ui` | add shadcn components | |
| 64 | +| `bun db:push` | apply db schema changes | |
| 65 | +| `bun db:auth` | update auth-related tables | |
| 66 | +| `bun db:studio` | open visual db editor | |
102 | 67 |
|
103 |
| -- Relivator **1.4.0+** is AI-ready — optimized for AI-powered IDEs like Cursor, making onboarding effortless even for beginners. |
104 |
| -- Version **1.3.0** evolved into **Versator**, featuring [Clerk](https://clerk.com) authentication and [Stripe](https://stripe.com) payments. Explore [Versator Demo](https://versator.relivator.com/en), [Repo](https://github.com/blefnk/versator), or [Docs](https://docs.reliverse.org/versator). |
| 68 | +## notes |
105 | 69 |
|
106 |
| -<!-- |
107 |
| -- ⚙️ **Instant setup**: Just run the CLI |
108 |
| -- 🤖 **AI-Ready**: Optimized for tools like [Cursor](https://cursor.sh) |
109 |
| -- 🧪 **Battle-tested stack**: Built for actual shipping, not just tutorial clout |
110 |
| -- 💡 **Evolving fast**: Frequent updates, including Relivator's variants like [Versator](https://versator.relivator.com) |
111 |
| -- --> |
| 70 | +- relivator **1.4.0+** is ai-ready — optimized for ai-powered ides like cursor, making onboarding effortless even for beginners. |
| 71 | +- version **1.3.0** evolved into **versator**, featuring [clerk](https://clerk.com) authentication and [stripe](https://stripe.com) payments. explore [versator demo](https://versator.relivator.com/en), [repo](https://github.com/blefnk/versator), or [docs](https://docs.reliverse.org/versator). |
112 | 72 |
|
113 |
| -## Stand with Ukraine |
| 73 | +## stand with ukraine |
114 | 74 |
|
115 |
| -- 💙 Help fund drones, medkits, and victory. |
116 |
| -- 💛 Every dollar helps stop [russia's war crimes](https://war.ukraine.ua/russia-war-crimes) and saves lives. |
117 |
| -- 👉 [Donate now](https://u24.gov.ua), it matters. |
| 75 | +- help fund drones, medkits, and victory. |
| 76 | +- every dollar helps stop [russia's war crimes](https://war.ukraine.ua/russia-war-crimes) and saves lives. |
| 77 | +- [donate now](https://u24.gov.ua), it matters. |
118 | 78 |
|
119 |
| -## Stand with Reliverse |
| 79 | +## stand with reliverse |
120 | 80 |
|
121 |
| -- ⭐ [Star the repo](https://github.com/blefnk/relivator) to help Reliverse community grow. |
122 |
| -- 🦄 Follow this project's author, [Nazar Kornienko](https://github.com/blefnk) & [Reliverse](https://github.com/reliverse), to get updates about new projects. |
123 |
| -- 💖 [Become a sponsor](https://github.com/sponsors/blefnk) and power the next wave of tools that _just feel right_. |
124 |
| -- 🧑🚀 Every bit of support helps keep the dream alive: dev tools that don't suck. |
| 81 | +- [star the repo](https://github.com/blefnk/relivator) to help the reliverse community grow. |
| 82 | +- follow this project's author, [nazar kornienko](https://github.com/blefnk) and his [reliverse](https://github.com/reliverse) ecosystem, to get updates about new projects faster. |
| 83 | +- [become a sponsor](https://github.com/sponsors/blefnk) and power the next wave of tools that _just feel right_. |
| 84 | +- every bit of support helps keep the dream alive: dev tools that don't suck. |
125 | 85 |
|
126 |
| -## License |
| 86 | +## license |
127 | 87 |
|
128 |
| -2025 MIT © [blefnk Nazar Kornienko](https://github.com/blefnk) & [Reliverse](https://github.com/reliverse) |
| 88 | +mit © 2025 [nazar kornienko (blefnk)](https://github.com/blefnk), [reliverse](https://github.com/reliverse) |
0 commit comments