Run any Skill in Manus with one click

stacks-desktop

Stars620

Forks17

UpdatedMarch 23, 2026 at 16:49

Use when building desktop applications with Stacks — Tauri integration, dev windows, system tray, or desktop-specific features. Covers @stacksjs/desktop (currently stubbed, Tauri integration pending).

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

stacksjs

stacksjs/stacks

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	stacks-desktop
description	Use when building desktop applications with Stacks — Tauri integration, dev windows, system tray, or desktop-specific features. Covers @stacksjs/desktop (currently stubbed, Tauri integration pending).
license	MIT
compatibility	Bun >= 1.3.0, TypeScript
allowed-tools	Read Edit Write Bash Grep Glob

Stacks Desktop

Key Paths

Core package: storage/framework/core/desktop/src/
Source: storage/framework/core/desktop/src/index.ts
System tray views: storage/framework/defaults/views/system-tray/
System tray layouts: storage/framework/defaults/layouts/system-tray/
System tray router types: storage/framework/types/system-tray-router.d.ts
Package: @stacksjs/desktop

API

import { openDevWindow } from '@stacksjs/desktop'
import type { Desktop, OpenDevWindowOptions } from '@stacksjs/desktop'

interface OpenDevWindowOptions {
  title?: string
  width?: number
  height?: number
  darkMode?: boolean
  hotReload?: boolean
  nativeSidebar?: boolean
  sidebarWidth?: number
  sidebarConfig?: unknown
}

async function openDevWindow(port: number, options?: OpenDevWindowOptions): Promise<boolean>

Desktop Interface (Tauri API surface)

interface Desktop {
  app: unknown
  core: unknown
  dpi: unknown
  event: unknown
  image: unknown
  menu: unknown
  mocks: unknown
  path: unknown
  tray: unknown
  webview: unknown
  webviewWindow: unknown
  window: unknown
}

Current Status

The Tauri integration is currently stubbed. openDevWindow() returns false — the actual Tauri API calls are commented out pending implementation.

CLI Commands

buddy dev:desktop       # Start desktop dev server
buddy build:desktop     # Build desktop application

Related Files

System tray views use STX templates in storage/framework/defaults/views/system-tray/
System tray has its own router type definitions
Desktop layouts in storage/framework/defaults/layouts/system-tray/

Gotchas

Currently incomplete — openDevWindow() is a stub that returns false
Tauri integration pending — the Desktop interface maps to Tauri's API but imports are commented out
System tray is separate — system tray views and routing have their own type definitions
Platform-specific builds — desktop builds require platform-specific Tauri compilation
Dev window options exist but aren't functional — OpenDevWindowOptions is defined but not yet wired to Tauri

More from this repository

same repository

stacks-browse

stacksjs/stacks

Use for headless browser QA on Stacks applications — navigation, screenshots, responsive testing, console/network monitoring, and accessibility snapshots. Dependency-free: drives a system browser over the Chrome DevTools Protocol using only Bun (no Playwright/Puppeteer). Invoke with /stacks-browse.

2026-06-16620

stacks-crosswind

stacksjs/stacks

Use when styling components in a Stacks application — utility-first CSS classes, theming, responsive design, variants, custom rules, or CSS generation. Crosswind is the CSS utility engine powering Stacks' Crosswind config.

2026-05-23620

stacks-ui

stacksjs/stacks

Use when working with UI in a Stacks application — components, composables, reactivity (refs/watch/computed), Craft native components, Crosswind CSS, Crosswind utility framework, accessibility, or the STX templating engine. Covers @stacksjs/ui, @stacksjs/stx, and related UI tooling.

2026-05-23620

stacks-api

stacksjs/stacks

Use when building, modifying, or debugging API endpoints in a Stacks application — defining routes, handling requests, API middleware, working with the API server, HTTP client (fetcher), API resources, or OpenAPI generation. Covers both @stacksjs/api utilities and the stacks-api server implementation.

2026-05-20620

stacks-router

stacksjs/stacks

Use when working with routing in a Stacks application — defining routes, HTTP methods, route groups, middleware, named routes, URL generation, request enhancement (Laravel-style input/query/file helpers), response helpers, error responses, route model binding, or rate limiting. Covers @stacksjs/router, routes/, and app/Routes.ts.

2026-05-20620

stacks-routes

stacksjs/stacks

Use when defining or organizing route files in a Stacks application — creating route files in routes/, registering them in app/Routes.ts, using route prefixes and middleware groups, or the default API routes structure. For the router API itself (request helpers, response helpers, middleware classes), see stacks-router.

2026-05-20620

name	stacks-desktop
description	Use when building desktop applications with Stacks — Tauri integration, dev windows, system tray, or desktop-specific features. Covers @stacksjs/desktop (currently stubbed, Tauri integration pending).
license	MIT
compatibility	Bun >= 1.3.0, TypeScript
allowed-tools	Read Edit Write Bash Grep Glob

Stacks Desktop

Key Paths

Core package: storage/framework/core/desktop/src/
Source: storage/framework/core/desktop/src/index.ts
System tray views: storage/framework/defaults/views/system-tray/
System tray layouts: storage/framework/defaults/layouts/system-tray/
System tray router types: storage/framework/types/system-tray-router.d.ts
Package: @stacksjs/desktop

API

import { openDevWindow } from '@stacksjs/desktop'
import type { Desktop, OpenDevWindowOptions } from '@stacksjs/desktop'

interface OpenDevWindowOptions {
  title?: string
  width?: number
  height?: number
  darkMode?: boolean
  hotReload?: boolean
  nativeSidebar?: boolean
  sidebarWidth?: number
  sidebarConfig?: unknown
}

async function openDevWindow(port: number, options?: OpenDevWindowOptions): Promise<boolean>

Desktop Interface (Tauri API surface)

interface Desktop {
  app: unknown
  core: unknown
  dpi: unknown
  event: unknown
  image: unknown
  menu: unknown
  mocks: unknown
  path: unknown
  tray: unknown
  webview: unknown
  webviewWindow: unknown
  window: unknown
}

Current Status

The Tauri integration is currently stubbed. openDevWindow() returns false — the actual Tauri API calls are commented out pending implementation.

CLI Commands

buddy dev:desktop       # Start desktop dev server
buddy build:desktop     # Build desktop application

Related Files

System tray views use STX templates in storage/framework/defaults/views/system-tray/
System tray has its own router type definitions
Desktop layouts in storage/framework/defaults/layouts/system-tray/

Gotchas

Currently incomplete — openDevWindow() is a stub that returns false
Tauri integration pending — the Desktop interface maps to Tauri's API but imports are commented out
System tray is separate — system tray views and routing have their own type definitions
Platform-specific builds — desktop builds require platform-specific Tauri compilation
Dev window options exist but aren't functional — OpenDevWindowOptions is defined but not yet wired to Tauri