Nuxt 3 template

Nuxt 3 template is a opinionated template for Nuxt 3 project. It includes the following features:

UnoCSS for utility-first CSS
Vuetify for component library
Nuxt i18n for internationalization
Nuxt Auth for authentication
Drizzle ORM for Database communication
CASL for Access Control
Firebase Notification for push notification

Getting Started

Prerequisites

PNPM - Fast, disk space efficient package manager
Node.js 20+ - Recommend to be installed via PNPM standalone using pnpm env use --global

Installation

Clone the repository

git clone git@github.com:thecodeorigin/nuxt-template.git

Install dependencies

pnpm install

Prepare the environment

Copy the .env.example file to .env and fill in the necessary information

cp .env.example .env

Prepare the Database with Docker

You can use a remote database and fill in all the environment variables in the .env file. Or you can use the provided docker-compose file to start a local database.

Please be careful with your configured environment variables, you can accidentally execute the database commands on your production database.

pnpm db:start

pnpm db:migrate

pnpm db:seed

Please checkout the server/db/seeds folder to review all the seed data, especially the users.seed.ts file to get the default user credentials.

You can stop or reset the database with the following commands:

# Stop the database
pnpm db:stop
# Reset the database
pnpm db:reset

Run the project

pnpm dev

Usage with Doppler

You can use Doppler to manage your environment variables. To do this, you need to install the Doppler CLI and authenticate with your account.

Install the Doppler CLI

Please follow the instructions on the official Doppler documentation to install the Doppler CLI.

Authenticate with Doppler

doppler login

Select the project from Doppler

doppler setup

Run the project with Doppler

Please be careful with your configured environment variables, you can accidentally execute the database commands on your production database.

pnpm with-env dev

Contribution

Thank you to all the people who already contributed to the Nuxt Template project!

_{Rim (Y Nguyen)}
💻

_{Nguyễn Đức Truyền}
🚧

_{Trịnh Huy Nam}
🚧

_{HaoNguyen-Ron}
🚧

_{Minh Dong}
🚧

License

MIT

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!