Introduction

What is Linch Desktop Core

Linch Desktop Core is a desktop application framework based on Tauri v2 and React 19. It provides a complete out-of-the-box solution to help developers quickly build cross-platform desktop applications.

With Linch Desktop Core, you can focus on business logic development without spending time on infrastructure setup.

Core Features

Shell Layout

Out-of-the-box application layout including:

Configurable sidebar navigation
Native-style title bar (with window dragging support)
Responsive main content area
Flexible slot system

SQLite Database

Local data storage based on @tauri-apps/plugin-sql:

Automatic initialization and migration system
Built-in settings storage (key-value pairs)
UI state persistence
Full transaction support

Auto Updates

Integrated Tauri Updater plugin:

Automatic update check on startup
Download progress display
One-click update installation

Internationalization

Multi-language support based on i18next:

Default support for Chinese and English
Automatic merging of app and base translations
React Hooks integration

Theme System

Flexible theme customization:

Light/Dark/System three modes
Configurable colors, border radius, and fonts
CSS variables support

Error Monitoring

Optional Sentry integration:

Automatic exception capture
User feedback collection
Performance monitoring

Tech Stack

Layer	Technology
Frontend Framework	React 19
Type System	TypeScript
Styling	Tailwind CSS 4
UI Components	shadcn/ui
Desktop Framework	Tauri 2
Backend Language	Rust
Database	SQLite
i18n	i18next
Routing	react-router-dom

Packages

Linch Desktop Core consists of three packages:

Package	Type	Description
`@linch-tech/desktop-core`	npm	Frontend components, hooks, utilities
`linch_tech_desktop_core`	Rust crate	Tauri plugin initialization, registers all necessary Tauri plugins
`@linch-tech/create-desktop-app`	npm CLI	Scaffolding tool for creating new projects

Why Choose Linch Desktop Core

Out-of-the-box

No need to build project structure from scratch. A single command creates a complete project skeleton including:

Pre-configured Tauri + React project
Complete build toolchain
Common feature modules

Configuration-driven

Control all aspects of the application through a single configuration object:

const config: LinchDesktopConfig = {
  brand: { name: 'My App' },
  nav: [...],
  features: { updater: true, database: true },
  theme: { ... },
  // ...
};

Type-safe

Complete TypeScript type definitions for intelligent hints and type checking in your editor.