React_clothing_brand

Lunark Wear Monorepo (Next.js Full-Stack)

This project is a full-stack Next.js App Router application with clean root-level separation:

• frontend: Next.js app (UI, pages, API route handlers)
• backend: Prisma, auth, repositories, services, validators, payment logic
• shared: safe shared constants/types

Root Structure

project-root/
  frontend/
  backend/
  shared/
  scripts/
  .env.example
  .gitignore
  package.json
  README.md

Frontend

frontend contains:

• src/app route groups:
  • (public), (auth), (user), (admin)
  • api/* route handlers (thin controllers only)
• src/components/* (layout/ui/product/cart/checkout/admin/auth)
• src/hooks, src/store, src/styles, src/types
• public/uploads/* assets and images

Backend

backend contains:

• prisma/schema.prisma, migrations, seed
• src/config/env.ts
• src/db/prisma.ts
• src/repositories/*
• src/services/*
• src/auth/*
• src/payment/*
• src/validators/*
• src/types/*
• src/utils/*

Shared

shared contains:

• shared/constants/routes.ts
• shared/constants/roles.ts
• shared/types/index.ts

Environment Setup

1. Copy root .env.example to frontend/.env (and optionally frontend/.env.local):

DATABASE_URL="file:./dev.db"
AUTH_SECRET="change_this_to_a_long_random_secret"
NEXT_PUBLIC_APP_NAME="Lunark Wear"
ESEWA_GATEWAY_URL="https://rc-epay.esewa.com.np/api/epay/main/v2/form"
ESEWA_STATUS_URL="https://rc-epay.esewa.com.np/api/epay/transaction/status/"
ESEWA_PRODUCT_CODE="EPAYTEST"
ESEWA_SECRET_KEY="replace_with_esewa_secret"

DATABASE_URL="file:./dev.db" is resolved by backend Prisma initialization to backend/prisma/dev.db.

Commands (run from root)

npm run prisma:generate
npm run db:seed
npm run dev

Other commands:

• npm run lint
• npm run build
• npm run start
• npm run prisma:migrate
• npm run prisma:studio
• npm run migrate:old-data

Auth Seed Accounts

• superadmin@erp.com / SuperAdmin@123
• user@erp.com / User@123

Notes

• API handlers stay in frontend/src/app/api by Next.js requirement.
• API handlers call backend modules via @backend/* aliases.
• Client components do not import backend modules.
• eSewa secret/signature logic is server-side in backend/src/payment/esewa.service.ts.