
ReLuxury
Luxury consignment operations platform with staff role-based access, consignment intake loop, and inventory workflows.
reluxury
This project was created with Better-T-Stack, a modern TypeScript stack that combines React, TanStack Start, Self, and more.
Features
- TypeScript - For type safety and improved developer experience
- TanStack Start - SSR framework with TanStack Router
- TailwindCSS - Utility-first CSS for rapid UI development
- Shared UI package - shadcn/ui primitives live in
packages/ui - Drizzle - TypeScript-first ORM
- SQLite/Turso - Database engine
- Authentication - Better-Auth
- Oxlint - Oxlint + Oxfmt (linting & formatting)
- Turborepo - Optimized monorepo build system
Getting Started
First, install the dependencies:
bun install
Database Setup
This project uses SQLite with Drizzle ORM.
Start the local SQLite database (optional): D1 local development and migrations are handled automatically by Alchemy during dev and deploy.
Update your
.envfile in theapps/webdirectory with the appropriate connection details if needed.Apply the schema to your database:
bun run db:push
Then, run the development server:
bun run dev
Open http://localhost:3001 in your browser to see the fullstack application.
UI Customization
React web apps in this stack share shadcn/ui primitives through packages/ui.
- Change design tokens and global styles in
packages/ui/src/styles/globals.css - Update shared primitives in
packages/ui/src/components/* - Adjust shadcn aliases or style config in
packages/ui/components.jsonandapps/web/components.json
Add more shared components
Run this from the project root to add more primitives to the shared UI package:
npx shadcn@latest add accordion dialog popover sheet table -c packages/ui
Import shared components like this:
import { Button } from "@reluxury/ui/components/button";
Add app-specific blocks
If you want to add app-specific blocks instead of shared primitives, run the shadcn CLI from apps/web.
Deployment (Cloudflare via Alchemy)
- Target: web + server
- Dev: bun run dev
- Deploy: bun run deploy
- Direct prod deploy: bun run deploy:prod:direct
- Cloudflare profile login: bun run alchemy:login:cloudflare
- Cloudflare profile relogin: bun run alchemy:relogin:cloudflare
- Cloudflare profile prod deploy: bun run deploy:prod:cloudflare
- Destroy: bun run destroy
Use bun run deploy:prod:direct from a locally authenticated machine when
GitHub Actions does not have the production credentials. Keep production
bindings outside source control, including BETTER_AUTH_SECRET,
SHIPPO_API_KEY, and any Cloudflare account/D1 credentials required by
Alchemy.
If your Alchemy Cloudflare profile is named cloudflare, run
bun run alchemy:login:cloudflare once, then bun run deploy:prod:cloudflare.
If deploy fails with invalid_grant or an expired refresh token, run
bun run alchemy:relogin:cloudflare and retry the deploy.
For more details, see the guide on Deploying to Cloudflare with Alchemy.
Git Hooks and Formatting
- Format and lint fix:
bun run check
Project Structure
reluxury/
├── apps/
│ └── web/ # Fullstack application (React + TanStack Start)
├── packages/
│ ├── ui/ # Shared shadcn/ui components and styles
│ ├── auth/ # Authentication configuration & logic
│ └── db/ # Database schema & queries
Available Scripts
bun run dev: Start all applications in development modebun run build: Build all applicationsbun run dev:web: Start only the web applicationbun run check-types: Check TypeScript types across all appsbun run db:push: Push schema changes to databasebun run db:generate: Generate database client/typesbun run check: Run Oxlint and Oxfmt