Skip to content

Create a Project

One thing that makes Tauri so flexible is it’s ability to work with virtually any frontend framework. We’ve created the create-tauri-app utility to help you create a new Tauri project using one of the officially maintained framework templates.

create-tauri-app currently includes templates for vanilla (HTML, CSS and JavaScript without a framework), Vue.js, Svelte, React, SolidJS, Angular, Preact, Yew, Leptos, and Sycamore. You can also find or add your own community templates and frameworks in the Awesome Tauri repo.

Alternatively, you can add Tauri to an existing project to quickly turn your existing codebase into a Tauri app.

Using create-tauri-app

To get started using create-tauri-app run one of the below commands in the folder you’d like to setup your project. If you’re not sure which command to use we recommend the Bash command on Linux and macOS and the PowerShell command on Windows.

sh <(curl --beta

Follow along with the prompts to choose your project name, frontend language, package manager, and frontend framework, and frontend framework options if applicable.

After create-tauri-app has complete you can navigate into your project’s folder, install dependencies, then use the Tauri CLI to start the development server:

cd tauri-app
npm install
npm run tauri dev

You’ll now see a new window open with your app running.

Congratulations! You’ve made your Tauri app! 🚀

Manual Setup (Tauri CLI)

If you already have an existing frontend or prefer to set it up yourself, you can use the Tauri CLI to initialize the backend for your project separately.

  1. Create a new directory for your project and initialize the frontend. You can use plain HTML, CSS, and JavaScript, or any framework you prefer such as Next.js, Nuxt, Svelte, Yew, or Leptos. You just need a way of serving the app in your browser. Just as an example, this is how you would setup a simple Vite app:

    mkdir tauri-app
    cd tauri-app
    npm create vite@latest .
  2. Then, install Tauri’s CLI tool using your package manager of choice. If you are using cargo to install the Tauri CLI, you will have to install it globally.

    npm install -D @tauri-apps/cli@next
  3. Determine the URL of your frontend development server. This is the URL that Tauri will use to load your content. For example, if you are using Vite, the default URL is http://localhost:5173.

  4. In your project directory, initialize Tauri:

    npx tauri init

    After running the command it will display a prompt asking you for different options:

    What is your app name? tauri-app
    What should the window title be? tauri-app
    Where are your web assets located? ..
    What is the url of your dev server? http://localhost:5173
    What is your frontend dev command? pnpm run dev
    What is your frontend build command? pnpm run build

    This will create a src-tauri directory in your project with the necessary Tauri configuration files.

  5. Verify your Tauri app is working by running the development server:

    npx tauri dev

    This command will compile the Rust code and open a window with your web content.

Congratulations! You’ve created a new Tauri project using the Tauri CLI! 🚀

Next Steps

© 2024 Tauri Contributors. CC-BY / MIT