design-mobile-apps

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.

Skills liên quan

azure-resource-visualizer
microsoft
Chuyển đổi các nhóm tài nguyên Azure thành sơ đồ kiến trúc chi tiết hiển thị mối quan hệ và cấu hình tài nguyên. Khám phá tất cả tài nguyên trong một nhóm tài nguyên và phân tích cấu hình, phụ thuộc, kết nối giữa chúng. Tạo sơ đồ Mermaid được tổ chức theo các lớp logic (Mạng, Tính toán, Dữ liệu, Bảo mật, Giám sát) với chi tiết SKU và nhãn kết nối. Ánh xạ mối quan hệ bao gồm kết nối mạng, luồng dữ liệu, ràng buộc danh tính và phụ thuộc cấu hình trên...
devopsdesigndevelopment
expo-native-ui
expo
Khung mã nguồn mở. Xây dựng các màn hình Expo đẹp, mang cảm giác native. Bao gồm kiểu dáng Apple HIG, màu sắc ngữ nghĩa, điều khiển native, SF Symbols, media, hoạt ảnh, hiệu ứng hình ảnh, gradient, lưu trữ và bố cục đáp ứng. Để định tuyến và điều hướng, hãy sử dụng kỹ năng expo-router.
designdevelopment
expo-router
expo
Khung mã nguồn mở. Điều hướng và định tuyến cho Expo Router. Bao gồm các tuyến dựa trên tệp, nhóm và tuyến động, tổ chức thư mục, Liên kết có xem trước và menu ngữ cảnh, Stack gốc, tiêu đề trang, modal và trang tính biểu mẫu, NativeTabs, tiêu đề và thanh công cụ, và thanh tìm kiếm tiêu đề.
apidesigndevelopment
expo-ui
expo
Khung (Mã nguồn mở). Xây dựng giao diện người dùng gốc với gói @expo/ui: SwiftUI thực trên iOS và Jetpack Compose trên Android được hiển thị từ React trong ứng dụng Expo hoặc React Native. Bao gồm các thành phần đa nền tảng phổ quát (Host, Column, Row, Button, Text, List, và nhiều hơn nữa được nhập từ @expo/ui), các thay thế trực tiếp cho các thư viện cộng đồng React Native phổ biến (BottomSheet, DateTimePicker, Slider, Menu, v.v.), và SwiftUI dành riêng cho nền tảng (@expo/ui/swift-ui, chỉ iOS) và Jetpack Compose...
designdevelopment
ui-sdk
vercel
Xây dựng giao diện bằng ui-sdk trong React, Vue, Svelte, Solid hoặc web components. Bao gồm việc chọn và kết hợp các thành phần của thư viện, xây dựng thành phần hoặc hành vi mà thư viện không cung cấp từ @ui-sdk/core (như stepper, splitter, danh sách chuyển mục hoặc bộ chọn emoji), giúp agent sử dụng giao diện thông qua createAgent, công cụ dành cho agent và WebMCP, cũng như kiểm thử bàn phím, tiêu điểm, ARIA, kết xuất phía máy chủ và bố cục từ phải sang trái, bao gồm cả việc viết kiểm thử cho một thành phần hiện có. Sử dụng bất cứ khi nào dự án có @ui-sdk/*...
testingdesigndevelopment
Web Interface Guidelines
Vercel
Xem xét mã giao diện người dùng để tuân thủ Web Interface Guidelines. Sử dụng khi được yêu cầu "xem xét giao diện người dùng của tôi", "kiểm tra khả năng tiếp cận", "kiểm toán thiết kế", "xem xét trải nghiệm người dùng" hoặc "kiểm tra trang web của tôi theo các thực hành tốt nhất".
designdevelopment
accessibility-engineering
addyosmani
Kiểm tra các giao diện hiện có để xác minh mức độ tuân thủ WCAG 2.2 AA và khắc phục các lỗi được phát hiện. Sử dụng khi kiểm tra khả năng truy cập của trang hoặc thành phần, chạy axe-core hoặc pa11y, phân loại lỗi a11y, hoặc kiểm tra các vấn đề về trình đọc màn hình và độ tương phản trước khi phát hành.
developmenttestingdesign
animate-expo
emilkowalski
Tạo hoạt ảnh trong React Native và Expo, đưa ra quyết định theo đúng thứ tự để xác định cảm giác chuyển động — có nên tạo hoạt ảnh hay không, chạy trên luồng nào, dùng thuộc tính nào, dùng spring hay timing, thao tác cử chỉ được chuyển giao ra sao và hoạt ảnh suy giảm như thế nào. Viết phần triển khai bằng Reanimated, Gesture Handler, Expo Router và expo-haptics. Dùng khi tạo hoạt ảnh cho bất kỳ thành phần nào trong ứng dụng Expo, thêm cử chỉ, sheet, chuyển cảnh màn hình, phản hồi khi nhấn hoặc phản hồi xúc giác, hay khắc phục chuyển động bị giật trên thiết bị. Dành cho...
developmentdesign