design-mobile-apps

작성자: designed-by-ai

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML.

npx skills add https://github.com/designed-by-ai/skills --skill design-mobile-apps

Designing with Sleek

Design mobile apps in minutes

Overview

sleek.design provides a REST API at /api/v1/* to create projects, design screens from a brief, and fetch their HTML and renders.

Base URL: https://sleek.design Auth: Authorization: Bearer $SLEEK_API_KEY, except the public device start/poll endpoints Content-Type: send application/json for JSON request bodies. CORS: Enabled on all /api/v1/* endpoints Envelope: check HTTP status first. Successful JSON wraps its payload in data; lists also include sibling pagination. Errors use top-level code, status and message, with optional data.url. Successful screenshots and share cards return image bytes; 204 has no body. Ids: opaque 11-character tokens like V1StGXR8Z5j, with no type prefix. Nothing about an id says whether it names a project, screen, component, version or theme, so track each one by the response field it arrived in. Parsing responses: write the body to a file (curl -o run.json) and parse the file. Piping JSON through echo corrupts it: zsh expands the escaped \n inside string values into real newlines, which makes the body invalid JSON. API docs: OpenAPI spec at https://sleek.design/api/v1/spec.json; browsable docs at https://sleek.design/api/v1/docs. Fetch the spec for any contract detail not covered here.


Designing or implementing

A single run can take both directions — "design me a fitness app and build it in Expo" is a design pass followed by an implementation pass. Gate each pointer on the artefact in front of you rather than on a one-time reading of the request:

Designing — you are about to send a chat message to Sleek. Read designing.md first; it carries the create → chat → screenshot loop, how to author a style direction, and when to seed one from a reference instead.

Implementing. Before writing code from a Sleek design, read implementing.md for version selection, native conversion, working features, and acceptance checks.

User shot and review shot

Screenshots come in two framings, and each file below asks for one by name:

  • A user shot is the default render: viewport height, phone-shaped. This is the one you show the user.
  • A review shot adds fullHeight: true, one component per request. This is the one you judge your own work against.

Prerequisites: API Key

If SLEEK_API_KEY is not set, use the device flow so the user never handles the raw key:

  1. POST https://sleek.design/api/v1/device/start (no auth) with body {"source": "your-tool-slug"}. The response contains a verificationUrl, a human-checkable userCode, a secret deviceCode, and a poll interval in seconds.
  2. Show the user the verificationUrl and the userCode, and tell them to confirm the code matches before approving.
  3. Poll POST https://sleek.design/api/v1/device/poll with {"deviceCode": "..."} every interval seconds. On pending, keep waiting. On approved, store data.key privately as SLEEK_API_KEY on that first read: the key is handed over once. On expired or 404 NOT_FOUND, start a new flow. See Device: Poll for the response contract.

Fallback: send the user to https://sleek.design/agents/setup, which handles sign-in, plan upgrade, and key creation in one place, and ask them to paste the key back to you. Keys can also be managed at https://sleek.design/dashboard/api-keys. The full key value is shown only once at creation, and a free account holds one active key at a time.

Plans: free accounts can try the API with their one-time trial credits (about one design run), so a new user can see their first design before any payment decision. Sustained use requires the Pro plan or higher. This file carries no figures on purpose — read the current price, billing periods and credit allowance from https://sleek.design/agents.md, which is generated from Sleek's live pricing, and quote them from there. When cost becomes relevant (the user asks, an upgrade is needed to continue, or you're about to send them to a payment page), state that pricing plainly, including the yearly option, so the user sees a payment step coming before they reach it.


Quick Reference: All Endpoints

Every endpoint the API exposes:

MethodPathScope
GET/api/v1/projectsprojects:read
POST/api/v1/projectsprojects:write
GET/api/v1/projects/:idprojects:read
DELETE/api/v1/projects/:idprojects:write
GET/api/v1/projects/:id/componentscomponents:read
GET/api/v1/projects/:id/components/:componentIdcomponents:read
GET/api/v1/referencesany valid key
POST/api/v1/projects/:id/chat/messageschats:write
GET/api/v1/projects/:id/chat/runs/:runIdchats:read
POST/api/v1/projects/:id/chat/runs/:runId/cancelchats:write
POST/api/v1/screenshotsscreenshots
POST/api/v1/share-cardsscreenshots
POST/api/v1/device/startpublic, no auth
POST/api/v1/device/pollpublic, no auth

Create a key holding only the scopes the task uses.

Every row above is specified in full — request body, response shape, field defaults, status codes — in endpoints.md. This table is enough to pick an endpoint; read the reference when you need a contract detail it doesn't carry.


Error Shapes

{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "...",
  "data": { "url": "https://sleek.design/..." }
}
HTTPCodeWhen
401UNAUTHORIZEDMissing/invalid/expired API key
403FORBIDDENValid key, wrong scope or plan
404NOT_FOUNDResource doesn't exist
400BAD_REQUESTValidation failure
409CONFLICTAnother run is active for this project
429TOO_MANY_REQUESTSRender cap: 1000 screenshots + share cards per hour per org, counted on API-key requests only
500INTERNAL_SERVER_ERRORServer error

401, 403 and 429 bodies may include data.url: a page where the user can fix the condition (create a key, upgrade the plan). Share it as-is.

Chat run-level errors (inside data.error):

CodeMeaning
out_of_creditsOrganization has no credits left
execution_failedAI execution error
cancelledRun cancelled via the cancel endpoint
request_message_persist_failedThe run failed before reaching the AI; the message was never stored

For out_of_credits, relay error.url and wait for the user to resolve it. Follow Safe retries for replay versus a new attempt after either recoverable failure.

관련 스킬

azure-resource-visualizer
microsoft
Azure 리소스 그룹을 리소스 관계와 구성을 보여주는 상세 아키텍처 다이어그램으로 변환합니다. 리소스 그룹 내 모든 리소스를 검색하고 구성, 종속성 및 상호 연결을 분석합니다. SKU 세부 정보와 연결 레이블이 포함된 논리적 계층(네트워크, 컴퓨팅, 데이터, 보안, 모니터링)별로 구성된 Mermaid 다이어그램을 생성합니다. 네트워크 연결, 데이터 흐름, ID 바인딩 및 구성 종속성 등 관계를 매핑합니다.
devopsdesigndevelopment
expo-native-ui
expo
프레임워크(OSS). 아름답고 네이티브 느낌의 Expo 화면을 구축합니다. Apple HIG 스타일링, 시맨틱 색상, 네이티브 컨트롤, SF Symbols, 미디어, 애니메이션, 시각 효과, 그라디언트, 저장소 및 반응형 레이아웃을 다룹니다. 라우팅 및 탐색에는 expo-router 스킬을 사용하세요.
designdevelopment
expo-router
expo
프레임워크(오픈소스). Expo Router를 위한 내비게이션 및 라우팅. 파일 기반 라우트, 그룹 및 동적 라우트, 폴더 구성, 미리보기 및 컨텍스트 메뉴가 있는 Link, 네이티브 Stack, 페이지 제목, 모달 및 폼 시트, NativeTabs, 헤더 및 툴바, 헤더 검색 바를 다룹니다.
apidesigndevelopment
expo-ui
expo
프레임워크(오픈소스). @expo/ui 패키지로 네이티브 UI를 구축합니다: iOS에서는 실제 SwiftUI, Android에서는 Jetpack Compose를 React에서 렌더링하여 Expo 또는 React Native 앱에서 사용합니다. @expo/ui에서 가져온 범용 크로스 플랫폼 컴포넌트(Host, Column, Row, Button, Text, List 등), 인기 있는 React Native 커뮤니티 라이브러리(BottomSheet, DateTimePicker, Slider, Menu 등)의 드롭인 대체재, 그리고 플랫폼별 SwiftUI(@expo/ui/swift-ui, iOS 전용) 및 Jetpack Compose를 포함합니다...
designdevelopment
ui-sdk
vercel
Builds interfaces with ui-sdk in React, Vue, Svelte, Solid or web components. Covers choosing and composing its components, building a component or behavior it doesn't ship from @ui-sdk/core (like a stepper, splitter, transfer list or emoji picker), making the interface usable by agents through createAgent, agent tools and WebMCP, and testing keyboard, focus, ARIA, server rendering and right to left, including writing tests for an existing component. Use whenever a project has @ui-sdk/*...
testingdesigndevelopment
Web Interface Guidelines
Vercel
UI 코드를 검토하여 웹 인터페이스 가이드라인을 준수하는지 확인합니다. "내 UI 검토", "접근성 확인", "디자인 감사", "UX 검토", "내 사이트가 모범 사례에 부합하는지 확인" 요청 시 사용하세요.
designdevelopment
accessibility-engineering
addyosmani
Audits existing interfaces for WCAG 2.2 AA conformance and remediates the violations found. Use when auditing a page or component for accessibility, running axe-core or pa11y, triaging a11y violations, or checking screen reader and contrast issues before shipping.
developmenttestingdesign
animate-expo
emilkowalski
Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For...
developmentdesign