A modern fullstack boilerplate powered by:

• ⚛️ Frontend: Vite + React + Mantine
• 🔐 Authentication: Google Login + JWT
• 🌐 Backend: Node.js + Express + MongoDB

Create a new GitHub repository (e.g.):

https://github.com/kaushikkumarbz/url-shortener-dev-example

During repo creation, select .gitignore → Node.

git clone git@github.com:kaushikkumarbz/url-shortener-dev-example.git
cd url-shortener-dev-example

Inside the cloned folder:

npx create-bz-mern-app@latest

This will set up the following folder structure:

url-shortener-dev-example/
  ├── backend/
  └── frontend/

By default, .env files are ignored. But for Vite frontend to work properly, you should:

1. Open .gitignore
2. Replace:

   .env
   .env/*
   

   with:

   /backend/.env
   

✅ This allows:

• ✅ frontend/.env to be committed (used by Vite)
• 🔒 backend/.env to stay private (JWT, DB credentials)

MONGODB_URI=your_mongodb_connection_string
PORT=3000
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
JWT_SECRET=your_secure_jwt_secret

VITE_GOOGLE_CLIENT_ID=your_google_client_id
VITE_BZENV=development  # or production
VITE_DEV_PROXY=http://localhost:3000

Quick Start Start frontend and backend together from root:

npm run dev

If you prefer running frontend and backend separately, follow the setup steps below.

cd frontend
npm install
npm run build
npm start

cd ../backend
npm install
npm start

• Frontend: Vite, React, Mantine, Google OAuth2
• Backend: Node.js, Express, MongoDB, JWT
• Tooling: ESLint, Prettier, dotenv

Feel free to fork and create PRs to improve the boilerplate!

MIT © 2025 Kaushikk