nexu-io/open-design

export-download-debugging

Diagnose and fix browser, preview, or Electron export/download failures, especially image export issues involving Save As, Blob/Data URLs, the File System Access API, createWritable failures, and 0 KB files.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/nexu-io/open-design --skill export-download-debugging

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Export Download Debugging

Use this when an export or download appears to run but produces an empty, missing, or unusable file. It is tuned for browser previews, iframe capture, and Electron shells.

Core rule

Separate capture from save. Prove the export payload has non-zero bytes before debugging the destination path. A 0 KB file often means the native picker or host created the target file, then the write failed or was blocked.

Evidence

  • Record the payload type, MIME type, byte length, object URL or data URL path,

and thrown error name/message.

  • Check browser console output and app logs around showSaveFilePicker,

createWritable, <a download>, URL.createObjectURL, and URL revocation.

  • In Electron, inspect the will-download path: filename, MIME, file extension,

save dialog filters, cancellation, and final file size.

  • Confirm the actual downloaded file size on disk and whether it opens in a

normal image viewer.

Fix order

  1. Prepare and validate the export payload first; disable Save until bytes are

available.

  1. Prefer the simplest stable save channel for the host. If

showSaveFilePicker().createWritable() fails, is sandboxed, or creates empty files, route to <a download> or Electron's download manager instead.

  1. Avoid opening a native picker before the payload is ready. This prevents the

host from creating an empty destination file on later write failure.

  1. For PNG fallback, prefer a verified non-empty data URL when blob URLs,

revocation timing, CSP, or iframe sandboxing are suspicious.

  1. In Electron, add explicit Save As filters for exported image extensions

(.png, .jpg, .jpeg, .webp) so users can choose a real image target.

  1. Keep the UI restrained: format selection, filename/path hint, clear pending

and error states, and one primary save action.

Validation

  • Add or update tests for non-empty payload preparation, fallback save behavior,

file extension/MIME mapping, and UI disabled/error states.

  • Run focused export tests, then pnpm --filter @open-design/web typecheck.
  • If Electron download handling changed, also run

pnpm --filter @open-design/desktop typecheck.

  • Before landing, run pnpm guard, inspect the staged diff for unrelated files,

generated artifacts, and accidental secrets, then use the repository's PR quality-gate workflow if the fix is being prepared for review.

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
nexu-io
커뮤니티

redesign-existing-projects

Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS.

1시간 설치 수
4
GitHub Stars
10.9만
업데이트
11월 21일
nexu-io
커뮤니티

brandkit

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

1시간 설치 수
3
GitHub Stars
10.9만
업데이트
11월 21일
nexu-io
커뮤니티

frame-liquid-bg-hero

WebGL-style fluid displacement background with a quote overlay, suited to video intros, landing heroes, or posters.

1시간 설치 수
3
GitHub Stars
10.9만
업데이트
11월 21일
nexu-io
커뮤니티

industrial-brutalist-ui

Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.

1시간 설치 수
3
GitHub Stars
10.9만
업데이트
11월 21일