Skip to content

Latest commit

 

History

History
200 lines (151 loc) · 4.83 KB

README.md

File metadata and controls

200 lines (151 loc) · 4.83 KB

Rapidly scaffold out a new Tauri app project.

status Chat Server website https://good-labs.github.io/greater-good-affirmation/assets/images/badge.svg support changelog

Usage

To get started using create-tauri-app run one of the below commands in the folder you'd like to setup your project.

Bash:

sh <(curl https://create.tauri.app/sh)

or

sh <(wget https://create.tauri.app/sh)

Powershell:

irm https://create.tauri.app/ps | iex

Cargo:

cargo install create-tauri-app --locked
cargo create-tauri-app

NPM:

npm create tauri-app@latest

Yarn:

yarn create tauri-app

PNPM:

pnpm create tauri-app

Deno

deno run -A npm:create-tauri-app

Bun:

bunx create-tauri-app

Scaffold a new project (interactive)

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

  1. Choose a name and a bundle identifier (unique-id for your app):

    ? Project name (tauri-app) ›
    ? Identifier (com.tauri-app.app) ›
    
  2. Select a flavor for your frontend. First the language:

    ? Choose which language to use for your frontend ›
    Rust  (cargo)
    TypeScript / JavaScript  (pnpm, yarn, npm, bun)
    .NET  (dotnet)
    
  3. Select a package manager (if there are multiple available):

    Options for TypeScript / JavaScript:

    ? Choose your package manager ›
    pnpm
    yarn
    npm
    bun
    
  4. Select a UI Template and flavor (if there are multiple available):

    Options for Rust:

    ? Choose your UI template ›
    Vanilla
    Yew
    Leptos
    Sycamore
    

    Options for TypeScript / JavaScript:

    ? Choose your UI template ›
    Vanilla
    Vue
    Svelte
    React
    Solid
    Angular
    Preact
    
    ? Choose your UI flavor ›
    TypeScript
    JavaScript
    

    Options for .NET:

    ? Choose your UI template ›
    Blazor  (https://dotnet.microsoft.com/en-us/apps/aspnet/web-apps/blazor/)
    

Once completed, the utility reports that the template has been created and displays how to run it using the configured package manager. If it detects missing decencies on your system, it prints a list of packages and prompts how to install them.

Scaffold a new project (non-interactive)

You can also directly specify the project name, package manager and the template you want to use via additional command line options. For example, to scaffold a Svelte project in a my-tauri-app directory, run:

# curl
sh <(curl https://create.tauri.app/sh) my-tauri-app --template svelte
# wget
sh <(wget https://create.tauri.app/sh) my-tauri-app --template svelte
# powershell
$env:CTA_ARGS="--template svelte";irm https://create.tauri.app/ps | iex
# cargo
cargo create-tauri-app my-tauri-app --template svelte
# npm 6.x
npm create tauri-app@latest my-tauri-app --template svelte
# npm 7+, extra double-dash is needed:
npm create tauri-app@latest my-tauri-app -- --template svelte
# yarn
yarn create tauri-app my-tauri-app --template svelte
# pnpm
pnpm create tauri-app my-tauri-app --template svelte
# deno
deno run -A npm:create-tauri-app --template svelte
# Bun
bunx create-tauri-app my-tauri-app --template svelte

Currently supported template presets include:

  • vanilla
  • vanilla-ts
  • vue
  • vue-ts
  • svelte
  • svelte-ts
  • react
  • react-ts
  • preact
  • preact-ts
  • solid
  • solid-ts
  • angular
  • yew
  • leptos
  • sycamore
  • blazor

You can use . for the project name to scaffold in the current directory.

Semver

create-tauri-app is following Semantic Versioning 2.0.

Licenses

Code: (c) 2022 - The Tauri Programme within The Commons Conservancy.

MIT or MIT/Apache 2.0 where applicable.

Logo: CC-BY-NC-ND