Community코딩 & 개발github.com

tauri-docs

Tauri 2 앱, tauri.conf.json, 기능 및 권한, 명령어와 invoke, 이벤트와 채널, 플러그인, 번들링, 서명 및 업데이터, Tauri 1에서 마이그레이션을 안내합니다. Tauri 2 공식 문서를 기반으로 스코프, 관리 상태, 플러그인 제작, CSP 및 격리 패턴, 테스트 및 디버깅, Linux/Windows/macOS 패키지, 모바일 및 스토어 릴리스를 다룹니다. Tauri 2 앱 작성 또는 리뷰, 플러그인 또는 기능 추가, '허용되지 않음' 또는 '금지된 경로' 오류 수정, Rust와 웹뷰 간 IPC 연결, 데스크톱 또는 모바일 빌드 패키징/서명/배포, Tauri 1 또는 2.0 베타 프로젝트 업그레이드 시 사용하세요.

tauri-docs란 무엇인가요?

이 스킬은 Tauri 2 애플리케이션 개발을 위한 포괄적인 문서 가이드입니다. Rust 코어와 시스템 웹뷰(Windows는 WebView2, macOS/iOS는 WKWebView, Linux는 WebKitGTK)를 사용하여 데스크톱 및 모바일 앱을 구축하는 Tauri 2의 주요 개념과 패턴을 공식 문서를 기반으로 요약합니다. 프로젝트 구조, 보안 모델(기능/권한), IPC(명령어, 이벤트, 채널, 상태 관리), 설정 파일, 의존성 관리, 번들링, 서명(코드 서명, 공증), 업데이터, 그리고 Tauri 1에서의 마이그레이션까지 개발자가 자주 실수하는 함정과 권장 패턴을 중점적으로 다룹니다. 이 스킬은 Tauri 2.x 버전을 대상으로 하며, 각 참조 파일은 특정 작업(예: 플러그인 설치, 보안 기능 설정, 배포)에 맞춰 분리되어 있어 필요한 부분을 빠르게 찾아볼 수 있습니다. 또한 공식 문서의 URL이 모든 주장 뒤에 포함되어 있어 항상 원본을 확인할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/quentin-autret/claude-skills/tree/main/skills/tauri-docs

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Tauri 2 문서 가이드

개요

Tauri는 Rust 코어와 시스템 웹뷰(Windows: WebView2, macOS/iOS: WKWebView, Linux: WebKitGTK)로 렌더링되는 웹 프론트엔드로 데스크톱 및 모바일 앱을 구축합니다. 이 스킬은 공식 Tauri 2 가이드를 함정, 예상치 못한 기본값, 권장 패턴 및 Tauri 1 대체 항목으로 압축했습니다. 아래 및 참조 파일의 모든 주장은 해당 페이지의 URL로 끝나므로 확인할 수 있습니다.

지원 버전

Tauri 2.x, https://v2.tauri.app/ 에 문서화되어 있습니다. 문서는 메이저 2 이상으로 버전 관리되지 않습니다. 특정 마이너 버전이 필요한 기능(예: removeUnusedCommands 또는 이벤트 모킹)은 참조 파일에 명시되어 있습니다. 생성된 API, 설정 및 CLI 참조 페이지는 다루지 않습니다. 정확한 시그니처는 사이트에서 확인하세요.

탐색 방법

  1. 아래의 빠른 시작을 읽으십시오. 대부분의 실패 원인이 되는 규칙이 포함되어 있습니다.
  2. 마지막 표에서 작업에 해당하는 참조 파일만 여십시오.
  3. 각 참조 파일은 독립적이며 목차로 시작합니다.
  4. 주장을 확인하려면 그 뒤에 오는 URL을 여십시오.

빠른 시작: 규칙 및 함정

프로젝트 구조

  • 앱 코드는 src-tauri/src/lib.rs에 #[cfg_attr(mobile, tauri::mobile_entry_point)] 아래에 있습니다. main.rs는 app_lib::run()만 호출합니다. https://v2.tauri.app/start/project-structure/
  • Tauri는 정적 호스트입니다. SSG 또는 SPA 출력을 제공합니다. SSR은 실행되지 않습니다. build.devUrl과 일치하도록 개발 포트를 고정(strictPort: true)하고, src-tauri를 프론트엔드 와처에서 제외하십시오. https://v2.tauri.app/start/frontend/vite/
  • Windows는 Chromium, macOS와 Linux는 WebKit으로 렌더링됩니다. 두 엔진을 모두 테스트하십시오. https://v2.tauri.app/start/frontend/vite/

보안 모델

IPC

설정 및 의존성

배포

Tauri 1에서 마이그레이션

참조 파일

파일읽을 경우
references/getting-started.md사전 요구 사항 설치, 스캐폴딩, Vite/Next/Nuxt/SvelteKit/Trunk 연결, 데스크톱 또는 모바일 장치에서 tauri dev 실행
references/migration-from-v1.mdTauri 1 또는 2.0 베타 앱 업그레이드: 설정 키 이동, 제거된 기능, 이름이 변경된 API 및 환경 변수
references/security-capabilities.md기능, 권한, 권한 세트 또는 스코프 작성, 또는 "허용되지 않음" 오류 디버깅
references/security-csp-isolation.mdCSP 설정, 격리 패턴, 자산 프로토콜 스코프, 응답 헤더, 빌드 체인 강화
references/ipc-commands-and-state.md명령어, 인수, 오류, 비동기 명령어, 주입된 매개변수 및 관리 상태 정의
references/ipc-events-and-channels.md이벤트 발생 및 수신, 채널을 사용한 스트리밍, Rust에서 JS 평가
references/configuration-and-resources.md설정 형식 및 플랫폼 병합, 빌드 변형, 버전 동기화, 아이콘, 번들 리소스, 바이너리 크기
references/plugins-files-network-data.md공식 플러그인 설치, fs, dialog, opener, shell, http, upload, websocket, sql, store, stronghold 또는 log 사용
references/plugins-app-and-mobile.md단일 인스턴스, 딥 링크, 자동 시작, CLI, 글로벌 단축키, 창 상태, 포지셔너, 알림 및 모바일 장치 플러그인
references/plugin-authoring.md플러그인 작성: 명명, 설정, 훅, 명령어 권한, 스코프, Kotlin 및 Swift 코드
references/debugging.md개발 전용 코드, 릴리스의 devtools, IDE 디버깅, Linux 빈 창 또는 WebGL 문제
references/testing.md단위 테스트에서 IPC 모킹, WebDriver 종단간 테스트, CI에서 실행
references/distribute-linux.mddeb, rpm, AppImage, Flatpak, Snap 또는 AUR 패키지 빌드 및 ARM Linux 빌드
references/distribute-windows-macos.mdWindows MSI/NSIS 설치 프로그램, WebView2 설치 모드, macOS 앱 번들 및 DMG
references/distribute-mobile-and-stores.mdAndroid 서명 및 Google Play, iOS 서명, iOS 및 macOS용 App Store, Microsoft Store
references/code-signing-desktop.mdmacOS에서 서명 및 공증, Windows에서 인증서 또는 signCommand로 서명
references/updater-and-ci.md업데이터 설정, 업데이트 매니페스트 및 채널, tauri-action 릴리스 워크플로우
references/recipes-windows-tray-menu.md창 레이블, 사용자 정의 제목 표시줄, 시스템 트레이, 창 및 앱 메뉴
references/recipes-sidecar-splash-mobile.md사이드카 바이너리, Node.js 사이드카, 스플래시 화면, 파일 연결, 모바일 다중 창

출처 및 가져오기 세부 정보: SOURCES.md.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

eslint-docs

Teaches current ESLint 10 practices drawn from the official documentation. Use when writing, reviewing or fixing an eslint.config.js (flat config, defineConfig, files, ignores, globalIgnores, extends, languageOptions, globals, parsers, processors), configuring ESLint rules and severities, disable comments and inline config, running the CLI in CI (--fix, --cache, --quiet, --max-warnings, bulk suppressions, formatters, feature flags, MCP server), writing custom rules (meta, schema, fixes, suggestions, selectors, scope, code paths) and testing them with RuleTester, building plugins, shareable configs, custom parsers, processors or formatters, using the Node.js API (ESLint, Linter), or migrating to ESLint 9 or 10 from eslintrc. Triggers on eslint, eslint.config.js, flat config, .eslintrc, .eslintignore, @eslint/js, js/recommended, eslint-disable, no-unused-vars, no-restricted-imports, no-restricted-syntax, RuleTester, eslint-plugin, eslint-config, FlatCompat, context.getScope is not a function, ESLint 10.

grafana-cloud-docs

Grafana Cloud pitfalls, defaults, limits and current patterns from the Grafana, Mimir, Loki and Tempo docs, each tied to its docs URL. Use when sending OpenTelemetry data to Grafana Cloud, writing PromQL, LogQL or TraceQL, controlling cardinality and cost, designing alert rules, routing notifications, provisioning alerting, building Synthetic Monitoring checks, using the /apis dashboard API, choosing access policy tokens or service accounts, or migrating off API keys, the Loki Exporter and legacy /api routes.

javascript-docs

Teaches current JavaScript (ECMAScript) practice drawn from the MDN JavaScript documentation. Use when writing, reviewing or fixing modern JavaScript, choosing a built-in API, or replacing a deprecated pattern. Covers equality and coercion, let/const and the temporal dead zone, strict mode, ASI, functions, classes and private fields, objects, prototypes, Proxy, Reflect, Symbol, eval, operators (??, ?., spread, BigInt arithmetic), statements, Promise, async/await, Promise.try, iterators and iterator helpers, generators, using/await using, DisposableStack, WeakRef, Array (toSorted, at, groupBy, fromAsync), Map, Set methods, WeakMap, strings and Unicode, encodeURIComponent, RegExp (v flag, RegExp.escape, lastIndex), Number, Math, BigInt, JSON (rawJSON, revivers), typed arrays, ArrayBuffer, base64, SharedArrayBuffer, Atomics, Temporal, Date, Intl (DateTimeFormat, NumberFormat, Collator, Segmenter, PluralRules), errors (cause, Error.isError), ES modules, import attributes, import.meta, dynamic import.

next-intl-docs

Teaches current next-intl 4 practices for internationalizing Next.js apps, drawn from the official documentation. Use when setting up next-intl with the App Router, writing i18n/request.ts, adding a [locale] segment with defineRouting, createMiddleware in proxy.ts (formerly middleware.ts), building locale switchers with createNavigation, translating with useTranslations or getTranslations, passing messages to NextIntlClientProvider, writing ICU messages (plurals, select, rich text), formatting dates, numbers and lists with useFormatter, translating metadata, Server Actions, Route Handlers, localized 404 and error pages, static rendering with next/root-params, type-safe messages through AppConfig, testing with Jest, Vitest, Storybook, or extracting inline messages with useExtracted. Triggers on next-intl, useTranslations, getTranslations, NextIntlClientProvider, getRequestConfig, i18n routing, locale prefix, localePrefix, NEXT_LOCALE, hreflang, setRequestLocale, ICU messages, App Router internationalization.

nodejs-docs

Teaches Node.js practice drawn from the official Node.js API documentation, with pitfalls, surprising defaults, deprecations and replacements, each backed by its nodejs.org URL. Use when writing, reviewing, debugging or upgrading Node.js code, or choosing a built-in module (fs, crypto, streams, http, process, CLI flags, node:test, ESM/CommonJS, package.json exports, TypeScript type stripping, child_process, worker_threads, node:sqlite, deprecations).

playwright-docs

Pitfalls, surprising defaults and recommended patterns of Playwright Test for JavaScript and TypeScript, distilled from the official docs. Use when writing, reviewing, debugging or configuring Playwright tests (@playwright/test, playwright.config.ts, npx playwright test), including flaky tests, locators (getByRole, filter, strict mode), web-first assertions (expect, toHaveText, toBeVisible, expect.poll, toPass), fixtures, storageState authentication, project dependencies, timeouts, retries, network mocking (page.route, routeFromHAR, routeWebSocket), API testing, clock, aria snapshots, toHaveScreenshot, axe accessibility scans, traces, UI mode, reporters, CI, Docker, sharding, test locks, component testing with stories and mount, codegen, Playwright MCP, playwright-cli and migration from Puppeteer, Protractor, Testing Library or older Playwright versions.

postgresql-docs

Pitfalls, surprising defaults, PostgreSQL 18 changes and recommended patterns from the official PostgreSQL 18 documentation, each backed by its postgresql.org URL. Use when writing or reviewing PostgreSQL SQL, schema design, migrations and ALTER TABLE locks, indexes, transactions, isolation levels and retries, locking, upsert and MERGE, COPY, JSONB, timestamptz, generated and identity columns, partitioning, EXPLAIN, vacuum, roles, row-level security, PL/pgSQL, full-text search, connection settings, and upgrades to PostgreSQL 18.

react-docs

Writes, reviews and upgrades React 19.3 code from the official react.dev documentation. Use when writing components and Hooks, removing unnecessary useEffect calls, fixing Effect dependencies with useEffectEvent, building forms with Actions (useActionState, useOptimistic, useFormStatus, form action), using Server Components, 'use client', 'use server' and Server Functions, Suspense, use(), useTransition, useDeferredValue, ViewTransition, Activity, adopting React Compiler and eslint-plugin-react-hooks, deciding on useMemo, useCallback and memo, server rendering and hydration (createRoot, hydrateRoot, renderToPipeableStream, prerender), or migrating from React 18 (forwardRef, Context.Provider, ReactDOM.render, propTypes, defaultProps). Triggers on React, JSX, hooks, useState, useEffect, useRef, useContext, Server Components, RSC, Actions, React Compiler, Strict Mode, hydration mismatch, React 19 upgrade.

rust-std-docs

Gives current guidance from the official Rust standard library docs (std 1.99.1 stable) on pitfalls, panics, platform differences, discouraged APIs and newer stable replacements. Use when writing, reviewing or refactoring Rust code that uses std, especially collections (Vec, HashMap, BTreeMap, BinaryHeap, entry, extract_if, sort), Option/Result/error handling (expect, ?, Error, ExitCode, panic), iterators (collect, flatten, Peekable, try_fold), Box/Rc/RefCell/Cow/Pin/mem::take, Arc/Mutex/RwLock/OnceLock/LazyLock/thread::scope/mpsc/Condvar/atomics, String/str/fmt/format!/OsString/CString, io/fs/path (BufWriter, OpenOptions, PathBuf::join), process/env/net/time (Command, set_var, TcpStream, Instant, Duration), From/TryFrom/AsRef/Ord/Drop/Deref/Clone, and unsafe raw pointers, MaybeUninit, transmute, NonNull or integer overflow and float ordering.

socketio-docs

Builds, configures and debugs Socket.IO 4.8 servers and clients from the official Socket.IO v4 documentation. Use when writing a Node.js Socket.IO server (Express, Fastify, Koa, Bun, uWebSockets.js) or a socket.io-client app, emitting events with acknowledgements, timeout() and emitWithAck, broadcasting to rooms and namespaces, authenticating in middleware with the auth option, configuring CORS, reverse proxies and sticky sessions, scaling with the Redis, Redis Streams, Postgres, MongoDB or Cluster adapter, enabling connection state recovery and delivery guarantees, tuning reconnection, writing tests, troubleshooting connection issues, or migrating from Socket.IO v2 or v3. Triggers on Socket.IO, socket.io, socket.io-client, io(), new Server, emit, emitWithAck, acknowledgements, rooms, namespaces, broadcast, io.use, middleware, CORS, Redis adapter, sticky sessions, connection state recovery, reconnection, connect_error, Session ID unknown. Not for plain WebSocket servers such as ws without Socket.IO.

tailwindcss-docs

Teaches current Tailwind CSS v4 practices drawn from the official documentation. Use for any task that touches Tailwind CSS v4, even a small one, because many v3 habits silently break in v4. Use when writing or reviewing Tailwind CSS v4 code (utility classes, variants, arbitrary values, theme variables in @theme, @utility, @custom-variant, @apply, @reference, @source), setting up Tailwind in a framework or build tool (Vite plugin, PostCSS plugin, CLI, Next.js, SvelteKit, Nuxt, Angular, Laravel, Rails), customizing the theme (colors, fonts, breakpoints, spacing, animations), building dark mode with a class or data attribute, or migrating a project from Tailwind v3 (tailwind.config.js, @tailwind directives, darkMode class, safelist, bg-opacity, renamed shadow and outline utilities). Triggers on tailwindcss, @import "tailwindcss", @tailwindcss/vite, @tailwindcss/postcss, @tailwindcss/cli, @theme, @custom-variant dark, npx @tailwindcss/upgrade, upgrade to Tailwind v4.

tokio-docs

Gives current guidance from the official tokio documentation (tokio 1.54.1) on async Rust pitfalls, cancel safety, blocking code, surprising defaults and deprecated APIs. Use when writing, reviewing or debugging async Rust code that uses tokio, especially the runtime (#[tokio::main], #[tokio::test], Builder, enable_all, block_on, current_thread, LocalRuntime, shutdown, feature flags), tasks (spawn, JoinHandle, JoinSet, abort, spawn_blocking, block_in_place, LocalSet, spawn_local, task_local), select!, join!, try_join!, cancellation and graceful shutdown, sync primitives (Mutex across .await, RwLock, Semaphore, Notify, OnceCell), channels (mpsc backpressure, oneshot, broadcast lag, watch), time (sleep, interval, MissedTickBehavior, timeout, paused time, start_paused), I/O and networking (AsyncReadExt, BufWriter flush, split, io::copy, framing, TcpListener, TcpStream, UdpSocket), tokio::fs, process (Command, kill_on_drop, Child), signals (ctrl_c, Windows console events) and Windows named pipes.

typescript-docs

Configures, writes and upgrades TypeScript 6.0 code and tsconfig.json from the official TypeScript documentation. Use when upgrading from TypeScript 5.x to 6.0 (strict, types, rootDir, baseUrl, moduleResolution node, target es5, outFile, esModuleInterop), choosing module and moduleResolution, writing package.json exports and imports, fixing ESM and CommonJS interop, enabling verbatimModuleSyntax or erasableSyntaxOnly, setting up project references and tsc --build, writing .d.ts files, checking JavaScript with JSDoc, or debugging narrowing, generics, mapped types, decorators and enums. Triggers on TypeScript, tsc, tsconfig, TS5112, ignoreDeprecations, nodenext, bundler, .d.ts, @ts-check, TypeScript 6 upgrade.

typesense-docs

Pitfalls, surprising defaults and recommended patterns of the Typesense search engine, distilled from the official docs. Use when designing a Typesense collection schema, writing search parameters (q, query_by, filter_by, sort_by, facet_by, group_by), tuning typo tolerance and ranking, building vector, semantic or hybrid search, conversational RAG or natural language search, creating API keys and scoped search keys for multi-tenancy, indexing and import (JSONL, upsert, emplace, dirty_values), syncing from a primary database, reindexing through aliases, managing synonyms (synonym sets), curation sets and stopwords, joins, analytics rules and query suggestions, InstantSearch, migrating from Algolia, or running, clustering, backing up and upgrading a Typesense server.

vite-docs

Teaches current Vite 8 practices drawn from the official documentation. Use when writing or fixing a vite.config, migrating from Vite 7 (Rolldown and Oxc replacing Rollup and esbuild), configuring the dev server, proxy or HMR, handling import.meta.env and modes, tuning the production build, library mode, SSR, writing a Vite plugin, using the HMR or JavaScript API, or the Environment API. Triggers on vite.config, defineConfig, rolldownOptions, import.meta.env, loadEnv, optimizeDeps, ssrLoadModule, ModuleRunner, this.environment, upgrade to Vite 8.

vitest-docs

Teaches current Vitest 5 practices drawn from the official documentation. Use when writing, reviewing or fixing Vitest tests (test, describe, expect, test.for, fixtures with test.extend, hooks, snapshots), mocking with vi (vi.fn, vi.spyOn, vi.mock, vi.when, fake timers, stubGlobal, stubEnv), configuring vitest.config or projects, choosing an environment or pool, filtering and running tests in CI, measuring coverage with v8 or istanbul, debugging slow or flaky suites, testing components in browser mode with Playwright, or migrating from Jest, Mocha or Vitest 4. Triggers on vitest, vi.mock, vi.fn, vitest.config, toMatchSnapshot, expect.poll, coverage thresholds, browser mode, @vitest/browser-playwright, jsdom, happy-dom, migrate Jest to Vitest, upgrade Vitest 5.

관련 스킬