reliverse/relivator

README

🏬 relivator • next.js ecommerce starter

demo — sponsor — discord — github — docs

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.

stack

🧱 core: nextjs 15.3 + react 19.1 + ts 5.8
🎨 ui: tailwind 4.1 + shadcn/ui
🔒 auth: better-auth
🎬 anims: animejs
📦 storage: uploadthing
📊 analytics: vercel
🧬 db: drizzle-orm (pg) + neon/(🤔🔜)supabase
🏗️ dx: eslint + biome + knip
📝 forms: react-form (🔜 w.i.p) + arktype
📅 tables: react-table
🌐 i18n: next-intl (🔜 w.i.p)
💌 email: resend (🔜 w.i.p)
💳 payments: polar
🔑 api: orpc (🔜 w.i.p)

these features define the main reliverse stack. for an alternative setup—featuring clerk, stripe, trpc, and more—check out versator.

quick start

install git, node.js, bun.

run:

git clone https://github.com/blefnk/relivator.git
cd relivator
bun install
copy .env.example .env

fill in the required environment variables in the .env file.
optionally, edit the src/app.ts file to make the app yours.

run:

bun db:push # populate db with schema
bun dev # start development server
bun run build # build production version

edit something in the code manually or ask ai to help you.
done. seriously. you're building now.

commands

command	description
`bun dev`	start local development
`bun build`	create a production build
`bun latest`	install latest deps
`bun ui`	add shadcn components
`bun db:push`	apply db schema changes
`bun db:auth`	update auth-related tables
`bun db:studio`	open visual db editor

polar integration

relivator now integrates with polar for payment processing and subscription management.

features

checkout flow for subscription purchases
customer portal for managing subscriptions
webhook handling for subscription events
automatic customer creation on signup
integration with better-auth for seamless authentication

setup instructions

create an account on polar
create an organization and get an organization access token

configure your environment variables in .env:

POLAR_ACCESS_TOKEN="your_access_token"
POLAR_WEBHOOK_SECRET="your_webhook_secret"
POLAR_ENVIRONMENT="production" # or "sandbox" for testing

create products in the polar dashboard

update the product IDs in src/lib/auth.ts to match your polar products:

checkout: {
  enabled: true,
  products: [
    {
      productId: "your-product-id", // Replace with actual product ID from Polar Dashboard
      slug: "pro" // Custom slug for easy reference in Checkout URL
    }
  ]
}

run bun db:push to create the necessary database tables
start the application with bun dev

verification

to verify that the integration is working:

sign up for an account
navigate to the dashboard billing page (/dashboard/billing)
try subscribing to a plan
check that your subscription appears in the billing dashboard
test the customer portal by clicking "manage subscription"

api routes

the following api routes are available for payment processing:

/api/payments/customer-state - get the current customer state
/api/payments/subscriptions - get user subscriptions

notes

relivator 1.4.0+ is ai-ready — optimized for ai-powered ides like cursor, making onboarding effortless even for beginners.
version 1.3.0 evolved into versator, featuring clerk authentication and stripe payments. explore versator demo, repo, or docs.

stand with ukraine

💙 help fund drones, medkits, and victory.
💛 every dollar helps stop russia's war crimes and saves lives.
‼️ please, donate now, it matters.

stand with reliverse

⭐ star the repo to help the reliverse community grow.
😉 follow this project's author, nazar kornienko and his reliverse ecosystem, to get updates about new projects faster.
🦄 become a sponsor and power the next wave of tools that just feel right.

every bit of support helps keep the dream alive: dev tools that don't suck.

license

README

🏬 relivator • next.js ecommerce starter

demo — sponsor — discord — github — docs

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.

stack

🧱 core: nextjs 15.3 + react 19.1 + ts 5.8
🎨 ui: tailwind 4.1 + shadcn/ui
🔒 auth: better-auth
🎬 anims: animejs
📦 storage: uploadthing
📊 analytics: vercel
🧬 db: drizzle-orm (pg) + neon/(🤔🔜)supabase
🏗️ dx: eslint + biome + knip
📝 forms: react-form (🔜 w.i.p) + arktype
📅 tables: react-table
🌐 i18n: next-intl (🔜 w.i.p)
💌 email: resend (🔜 w.i.p)
💳 payments: polar
🔑 api: orpc (🔜 w.i.p)

these features define the main reliverse stack. for an alternative setup—featuring clerk, stripe, trpc, and more—check out versator.

quick start

install git, node.js, bun.

run:

git clone https://github.com/blefnk/relivator.git
cd relivator
bun install
copy .env.example .env

fill in the required environment variables in the .env file.
optionally, edit the src/app.ts file to make the app yours.

run:

bun db:push # populate db with schema
bun dev # start development server
bun run build # build production version

edit something in the code manually or ask ai to help you.
done. seriously. you're building now.

commands

command	description
`bun dev`	start local development
`bun build`	create a production build
`bun latest`	install latest deps
`bun ui`	add shadcn components
`bun db:push`	apply db schema changes
`bun db:auth`	update auth-related tables
`bun db:studio`	open visual db editor

polar integration

relivator now integrates with polar for payment processing and subscription management.

features

checkout flow for subscription purchases
customer portal for managing subscriptions
webhook handling for subscription events
automatic customer creation on signup
integration with better-auth for seamless authentication

setup instructions

create an account on polar
create an organization and get an organization access token

configure your environment variables in .env:

POLAR_ACCESS_TOKEN="your_access_token"
POLAR_WEBHOOK_SECRET="your_webhook_secret"
POLAR_ENVIRONMENT="production" # or "sandbox" for testing

create products in the polar dashboard

update the product IDs in src/lib/auth.ts to match your polar products:

checkout: {
  enabled: true,
  products: [
    {
      productId: "your-product-id", // Replace with actual product ID from Polar Dashboard
      slug: "pro" // Custom slug for easy reference in Checkout URL
    }
  ]
}

run bun db:push to create the necessary database tables
start the application with bun dev

verification

to verify that the integration is working:

sign up for an account
navigate to the dashboard billing page (/dashboard/billing)
try subscribing to a plan
check that your subscription appears in the billing dashboard
test the customer portal by clicking "manage subscription"

api routes

the following api routes are available for payment processing:

/api/payments/customer-state - get the current customer state
/api/payments/subscriptions - get user subscriptions

notes

relivator 1.4.0+ is ai-ready — optimized for ai-powered ides like cursor, making onboarding effortless even for beginners.
version 1.3.0 evolved into versator, featuring clerk authentication and stripe payments. explore versator demo, repo, or docs.

stand with ukraine

💙 help fund drones, medkits, and victory.
💛 every dollar helps stop russia's war crimes and saves lives.
‼️ please, donate now, it matters.

stand with reliverse

⭐ star the repo to help the reliverse community grow.
😉 follow this project's author, nazar kornienko and his reliverse ecosystem, to get updates about new projects faster.
🦄 become a sponsor and power the next wave of tools that just feel right.

every bit of support helps keep the dream alive: dev tools that don't suck.

gem-hunter