/nuxt3-starter

Minimal starter template for Nuxt 3

Primary LanguageTypeScript

Nuxt 3 Starter

This is an minimal starter template for Nuxt 3. It is based on the what we use and love at Input Studio.

Look at the Nuxt 3 documentation to learn more.

Features

  • 👓 Sass
  • 🪁 Tailwind CSS
  • 🇬 Google Fonts
  • 🚀 Nuxt Icon (add any icons from icones.js.org collection)
  • 🔍 Nuxt SEO (robots.txt, sitemap, link checker, etc.)
  • 🧰 VueUse (a collection of essential utilities — trust me, you'll need it at somepoint)
  • 💾 HTTP cache control and compression for static assets
  • 🪛 Eslint and Prettier with Tailwind plugin (automatically sorts classes based on recommended class order)
  • ⚙️ VS Code settings and recommended extensions
  • 🐋 Optimized Dockerfile for production (includes a GitHub Actions workflow to build and publish your Docker image)
  • 📦 Package manager agnostic (nuxi will ask you which package manager you want and it'll install dependencies accordingly)

Setup

Make sure to have Node.js version 20 or higher installed on your machine. If it's not the case, you can install volta. Volta will automatically install the required versions of Node.js.

Now, you can run the following command to create a new Nuxt 3 project based on this template:

npx nuxi init -t gh:inputstudio/nuxt3-starter <project-name>

After that, make sure to go through the TODOs (search for TODO in your code editor) to customize the project to your needs. Enjoy ✨

Which UI framework should I use?

This starter template uses Tailwind CSS by default. You can add any UI framework you want on top of it. Here are some that we use and recommend (they are all fully compatible with Tailwind):

Feel free to use any other UI framework you like 🙂.

Production

To build the application for production, run the following command:

npm run build

This will generate a dist directory containing the production build. You can preview the production build locally by running:

npm run preview

Check out the deployment documentation for more information.

Docker

Before you start, copy either the Dockerfile.npm or Dockerfile.yarn to Dockerfile in the root of your project. Depending on which package manager you want to use.

Building and running your application

When you're ready, start your application by running:

docker compose up

Your application will be available at http://localhost:3000.

Deploying your application to the cloud

First, build your image, e.g.: docker build -t myapp .. If your cloud uses a different CPU architecture than your development machine (e.g., you are on a Mac M1 and your cloud provider is amd64), you'll want to build the image for that platform, e.g.: docker build --platform=linux/amd64 -t myapp ..

Then, push it to your registry, e.g. docker push myregistry.com/myapp.

Consult Docker's getting started docs for more detail on building and pushing.

References