Top

Installation


How to Start

Welcome to Nuxt! Nuxt helps you build modern applications for the web, mobile, or desktop.

For getting started an Nuxt application you needs two things as Prerequisites.

Prerequisites

Before you begin, make sure your development environment includes

  • Node
  • npm (Node Package Manager)

Node.js

  • Download the above 20 , 22 & below 24 version node.js from nodejs.org.

  • Install Node.js using downloaded file

  • To check your node version, run node -v in a terminal/console window.

npm (Node Package Manager)

  • Nuxt 4 applications rely on features and functionality provided by libraries that are available as npm packages. To download and install these npm packages, you must have an npm package manager installed on your system (included with Node.js).

  • This Quick Start uses the npm client command line interface, which is installed with Node.js by default. To check that you have the npm client installed, run npm -v in a terminal/console window.

  • For a better understanding of Nuxt 4, we suggest going through the official documentation available at Nuxt Docs .

Nuxt setup

If you want Paris theme setup then directly follow next Paris setup section

Installing Nuxt CLI

  • Nuxt apps depend on features and functionality provided by libraries that are available as npm packages. To download and install npm packages, you must have an npm package manager.

  • You can create a Nuxt project without installing the CLI globally by using npx, which is the recommended approach

Create Initial Application

  • 1. Run the Nuxt CLI command to create your application. Using npx (recommended):

    npx nuxi init my-app
  • 2. The CLI will create a new Nuxt project in the my-app folder. Once created, navigate to the folder:

    cd my-app

Serve Application

  • 1. Install dependencies:

    npm install                          
    
  • 2. Launch the development server with the Nuxt command:

    npm run dev
Paris setup

If you have already download and install node.js and Nuxt 4 then ignore prerequisites accordingly.

Node.js

Download the above 20 , 22 & below 24 version node.js from nodejs.org.

Create Initial Application

npx nuxi init my-app
cd my-app

Setup Paris theme by

  • 1) Download and extract an Paris theme from themeforest
  • 2) Extract it and then go in to theme folder.
  • cd theme
  • 3) Import all dependency by installing npm command
  • npm install
  • 4) Now you are in stage to successfully run Paris using below command:
  • npm run dev

    Once you serve your application by default it will take their default port so you can open port using localhost:3000

    Make sure you are not running any other nuxt project in local if so then use new generated port from terminal with label called app running at:

    Some Common solution if you do not run project successfully
    • Use Latest Version of node.js
    • Remove node_module and package-lock.json file and again do npm install
    • You can again download theme from themeforst and then again run
    • Then also if you don't solve issue you can generate a ticket.

1. Build Your Application

To prepare your Nuxt project for hosting, run the following command in your terminal:

npm run build

This will generate a dist folder inside your project directory. Compress the dist folder into a ZIP file — this is the package you’ll upload to your server.

2. Configure Apache (.htaccess)

If you are hosting on an Apache HTTP Server, create a .htaccess file inside your dist folder (or inside the public folder if that’s your document root) with the following content:

  • Options -MultiViews
  • RewriteEngine On
  • RewriteCond %{REQUEST_FILENAME} !-f
  • RewriteRule ^ index.html [QSA,L]

3. Upload to Server

Upload the contents of your dist folder to the server’s public directory (or the directory your hosting provider specifies as the web root).

4. Deploying to a Subdirectory (Optional)

If you want your Nuxt app to run inside a subdirectory (for example, https://example.com/Paris/), update your nuxt.config.ts:

export default defineNuxtConfig({
  app: {
    baseURL: "/paris/" // Replace with your subdirectory name
  }
})

After updating nuxt.config.ts, run npm run build again to regenerate the dist folder.