A Next.js and Mongoose web application with Material UI as the design system WITH MINIMUM CUSTOM CSS, just bare-bones MUI with default theme and colors palette, designed as a starting point of any web application. All pages and components has stories with storybook v7.
https://next-js-mongo-db-mui-boilerplate.vercel.app/
This project was based in hoangvvo Next.js MongoDB boilerplate
- MVC Architecture
- Automatic dark/light mode
- Clean Material UI v5 implementation 💅
- Full API Routes implementation and Serverless ready
- Middleware pattern, compatible with Express ecosystem, powered by next-connect
Client: React 18, Next.js 13, Material UI 5
Server: Next.js 13, Node, Mongoose 7
Development: Storybook 7, Mongodb Memory Server, Jest, Prettier
- Session-based authentication (Passport.js)
- Sign up/Log in/Sign out API
- Authentication via email/password
- Email verification
- Password change
- Password reset via email
- Profile
- Profile picture, username, name, bio, email
- Update user profile
- Profile picture, username, name, bio, email
- Update user profile
To run this project, you will need to add the following environment variables to your .env file
CLOUDINARY_URL (optional, Cloudinary only) Cloudinary environment variable for configuration
MONGODB_URI (Required) The MongoDB Connection String (with credentials and database name)
WEB_URI(Required) The URL of your web app
NODEMAILER_CONFIG (Required) JSON stringified nodemailer config. eg: {"service":"Gmail","auth":{"user":"example@gmail.com","pass":"aHR0cHM6Ly95b3V0dS5iZS9kUXc0dzlXZ1hjUQ=="}}
- Start the development server by running yarn dev. Getting started by create a .env.local file with the above variables. See Environment Variables.
- Start Storybook with yarn storybook
Contributions are always welcome!
See contributing.md for ways to get started. You can create pull request to this project and be a contributor.