Skip to content
On this page

Development

Developing with Vite might be a bit different from what you may be used to in the Webpack world. To be more specific, Vite isn't a bundler. Rather, it's a pre-configured tooling pipeline that uses Rollup for building and a local server for development.

When you start Vite's development server, pre-optimisations are made on some of your dependencies. After that, your assets are being served - there is no bundling or compiling needed at that point, so starting the server is very fast.

With Laravel

Simply start the development server:

> npm run dev

  vite v2.7.13 dev server running at:

  > Local: http://localhost:5173/
  > Network: use `--host` to expose

  ready in 392ms.

Paths in your scripts, CSS and import statements will automatically be handled by Vite to point there, so you don't have to worry about it. You can keep using relative paths and aliases.

This server is not your application server

Its sole purpose is to serve assets, such as scripts or stylesheets. It is not where your application is served: you still need to use something like Valet, Laragon, Docker or php artisan serve.

Using HTTP over TLS

If you are using https locally, which you should, you will need to update the development server's URL to use the https protocol, and you will need to fill your environment variables with paths to your certificates.

With the default configuration, this means setting up, in your .env:

  • DEV_SERVER_URL, for instance https://localhost:300
  • DEV_SERVER_KEY, for instance C:/laragon/etc/ssl/laragon.key
  • DEV_SERVER_CERT, for instance C:/laragon/etc/ssl/laragon.crt

These are the default environment variables, but you can change them on a per-configuration basis in config/vite.php.

Using Valet or Laragon?

You may not need to fill the DEV_SERVER_KEY and DEV_SERVER_CERT environment variables, as they are inferred automatically.

Changing the host

The development server URL, configured via config/vite.php, is used for generating the tags and telling the Vite server which address to listen to.

This may not be desirable depending on your environment, for instance if working in a container. In such a case, you may configure Vite to listen to another host:

ts
import { defineConfig } from 'vite'
import laravel from 'vite-plugin-laravel'

export default defineConfig({
  server: {
    host: '0.0.0.0'
  },
  plugins: [
    laravel(),
  ],
})

Alternatively, you can use the --host 0.0.0.0 command line argument to do the same without changing the configuration file.

Using Laravel Sail

If using Sail, you will need to set it up to forward the port you are using to the container. Update your docker-compose.yml to add it:

yaml
ports:
    - '${APP_PORT:-80}:80'
    - '5173:5173'

The development server will run inside the container. To install dependencies, use sail npm ci. Then sail run dev to start the server.

Do not forget to configure Vite to listen to 0.0.0.0.

Development has loaded