{"_id":"playbook-sdk","_rev":"9-cb8b69cf62b05ab00869eca4cfca47cd","name":"playbook-sdk","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.1":{"name":"playbook-sdk","version":"1.0.1","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"beta@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.0.1","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"dist":{"shasum":"1d99a070cdb96db1633d25faa973c2ef8565e9dd","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.0.1.tgz","fileCount":4,"integrity":"sha512-LTopwn0drZqTohy/Qu/c6ocCs8kSCXDcsuWAm7BpK1m/y065oAvqTd37B7SEF2M4fI07nl04YXbgwXotL47xhQ==","signatures":[{"sig":"MEQCIATz8HT+WukjRqgtFFbDK934cb4+JCUu93lR8D2ZKmgnAiAk+3u4XbpQs8BsBYsW3o865PI4Y6dgCbnQ3VCQVXFjjA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64707},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"gitHead":"8420c58f2766dbe321056666aa1b019ba82b2e80","scripts":{"test":"echo 'No tests yet'","build":"echo 'Build complete'","prepublishOnly":"npm run build"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","_npmVersion":"9.8.1","description":"A lightweight, production-ready frontend SDK for creating beautiful galleries","directories":{},"_nodeVersion":"18.18.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.0.1_1764367552262_0.15406958205888666","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"playbook-sdk","version":"1.0.2","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"beta@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.0.2","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"dist":{"shasum":"d7fa77049c0f41f2879213cfb4acff757b8968c2","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.0.2.tgz","fileCount":4,"integrity":"sha512-m1McXdMU7uchuh8+MQxucvWcK2y2EA7m0JN38tU9f2lKNPqVgKw2ePP9F3N4eNkQIJ8JRxkCiyGZTTag3cTAgw==","signatures":[{"sig":"MEUCIQDCnlK3hbDTB1kzDzfgGtaHQZTUQ/ycJXlfDbvnHGERpwIgcBjOA528giOrWtCACwueuuQ8gdK36voRnEtbo6/WGmM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64651},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"gitHead":"43b1fc9109bfa9223338ea03f6b72290a1f96e71","scripts":{"test":"echo 'No tests yet'","build":"echo 'Build complete'","prepublishOnly":"npm run build"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","_npmVersion":"9.8.1","description":"A lightweight, production-ready frontend SDK for creating beautiful galleries","directories":{},"_nodeVersion":"18.18.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.0.2_1764367784566_0.5639102961816631","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"playbook-sdk","version":"1.0.3","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"beta@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.0.3","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"dist":{"shasum":"c9476c742b5852a5c3d1ce236f2deba32b50c6fb","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.0.3.tgz","fileCount":4,"integrity":"sha512-KeFX2bIDZPEV6kI1q2KFZURwyWAvUNiqo/aznejLSlB3nTP5JOeiOu/MWBWZq2c9ZaPLEM9tAPKe7YcZf3i5NA==","signatures":[{"sig":"MEQCIA3ieioA0BPvpdqdszm04D3/bmCNgWvRvQrLht33zdWvAiBwT/Vp5d3BQpPnJGE4GL/y01zyt4mZKTkuavphhycHrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65298},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"gitHead":"a6c16391e936eb6a5892b377e430746ee37cecb0","scripts":{"test":"echo 'No tests yet'","build":"echo 'Build complete'","prepublishOnly":"npm run build"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","_npmVersion":"9.8.1","description":"A lightweight, production-ready frontend SDK for creating beautiful galleries","directories":{},"_nodeVersion":"18.18.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.0.3_1764607227953_0.5901229905626044","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"playbook-sdk","version":"1.0.4","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"support@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.0.4","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"homepage":"https://github.com/playbook-labs/playbook-sdk#readme","bugs":{"url":"https://github.com/playbook-labs/playbook-sdk/issues"},"dist":{"shasum":"4a49128075cdb2ecbeb805709b70683239393b2b","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.0.4.tgz","fileCount":6,"integrity":"sha512-7HHgo80bdgL82UvbzB5ZMmTbFhgFmUkxXEpkJ3/qH4estqALAo8kQiOD97AaHjIPPESJwulHG/TtlwXt+mbwqw==","signatures":[{"sig":"MEYCIQCivsBAtyHu4XkdsIPysqkFSUscQgHYtW0vKjCMwDvnBwIhAKljtst9/MDhFPFIpF4FfFY7Mn5TLKxATrEuVzjaZjSM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDHtAAQzARQqlO4jUS1KZQmgc9qvx/Hmzw5w+GaDqDEcgIgDwxckZ25eNHMCc9HAKZHTfHfl4y1kmemf23tkR6kmfs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97603},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"exports":{".":{"types":"./index.d.ts","default":"./dist/playbook-sdk.min.js"}},"gitHead":"b8e84bcc4457e5bb6d8736bebed8841be12be413","scripts":{"test":"node --test","build":"node build.mjs","prepublishOnly":"npm run build && npm test"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","repository":{"url":"git+https://github.com/playbook-labs/playbook-sdk.git","type":"git"},"_npmVersion":"11.16.0","description":"A lightweight, zero-dependency frontend SDK for embedding beautiful, searchable media galleries backed by the Playbook API","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.24.2"},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.0.4_1790951985983_0.6419761446065155","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"playbook-sdk","version":"1.1.0","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"support@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.1.0","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"homepage":"https://github.com/playbook-labs/playbook-sdk#readme","bugs":{"url":"https://github.com/playbook-labs/playbook-sdk/issues"},"dist":{"shasum":"312011822da791c92f70a8f69e6f946d217ace9b","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.1.0.tgz","fileCount":6,"integrity":"sha512-o7aRyOsh9Z0g8ZjbNhVwV1d6HPklnnsrmYN0b8k4j7BEovJUWXb1xdGYTCKVDjXZbHD+WWs60GKGWFiZRDCYEg==","signatures":[{"sig":"MEUCIA+rmJBF5Kgg5obHBZkN/JLP3NMuzk8M/qhmueIQnEU7AiEA4cq2txy1vnjpQm9ojMSpcg843OltAWI22pfGZ5Z2dMg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC9Q7u5tM6+3ETjmcV0y5ZTwPJTU99fBwVyZd2XWIokMwIhAKesx5RhsieawSiRZWr5+xarGJzh/QXJqDVorhzkeslL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102239},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"exports":{".":{"types":"./index.d.ts","default":"./dist/playbook-sdk.min.js"}},"gitHead":"2f9490ff2400f4cfc9ded15e87c1a8d6e40dd756","scripts":{"test":"node --test","build":"node build.mjs","prepublishOnly":"npm run build && npm test"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","repository":{"url":"git+https://github.com/playbook-labs/playbook-sdk.git","type":"git"},"_npmVersion":"11.16.0","description":"A lightweight, zero-dependency frontend SDK for embedding beautiful, searchable media galleries backed by the Playbook API","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"packageManager":"yarn@4.18.1","devDependencies":{"esbuild":"^0.24.2"},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.1.0_1790952265524_0.8711651762830459","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"playbook-sdk","version":"1.2.0","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"author":{"name":"Playbook Labs","email":"support@playbook.com"},"license":"MIT","_id":"playbook-sdk@1.2.0","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"homepage":"https://github.com/playbook-labs/playbook-sdk#readme","bugs":{"url":"https://github.com/playbook-labs/playbook-sdk/issues"},"dist":{"shasum":"e87466111949886537422d9630a9d42f6b8b4b72","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.2.0.tgz","fileCount":18,"integrity":"sha512-poW6hFCAFR9Z9pzBY4Ab178eLUqMUFmDzNG+k0A3c2ePksw6949hplu6SPIhqWV7+jKALsZUfCAEnWqwrIQgTw==","signatures":[{"sig":"MEQCIDGp+tlssM8el1ySWc+rKwQleMm3O62sHIplL5aZfilMAiByQUgzN9P0eMk7ESUn58lJM3EtI9m/8Q/Zi/hMSjo4wg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCrcSCCZoDTuwyEH0Qx1iCBzv+DW5HTU/yoy7fth095sQIhAONVHhTKsQu5x3zKm/J/uwgHcvkN65STP8la5PKW7YkG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":231466},"main":"dist/playbook-sdk.min.js","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"exports":{".":{"types":"./index.d.ts","default":"./dist/playbook-sdk.min.js"},"./embed":{"types":"./index.d.ts","default":"./dist/playbook-embed.min.js"},"./picker":{"types":"./index.d.ts","default":"./dist/playbook-picker.min.js"},"./player":{"types":"./index.d.ts","default":"./dist/playbook-player.min.js"},"./search":{"types":"./index.d.ts","default":"./dist/playbook-search.min.js"},"./viewer":{"types":"./index.d.ts","default":"./dist/playbook-viewer.min.js"},"./uploader":{"types":"./index.d.ts","default":"./dist/playbook-uploader.min.js"}},"gitHead":"5c0fe31a070f0b9e0f5a4a9aacbb7d1e18de950b","scripts":{"test":"node --test","build":"node build.mjs","prepublishOnly":"npm run build && npm test"},"typings":"index.d.ts","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"jsdelivr":"dist/playbook-sdk.min.js","repository":{"url":"git+https://github.com/playbook-labs/playbook-sdk.git","type":"git"},"_npmVersion":"11.16.0","description":"A lightweight, zero-dependency frontend SDK for embedding beautiful, searchable media galleries backed by the Playbook API","directories":{},"_nodeVersion":"24.18.0","_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.24.2"},"_npmOperationalInternal":{"tmp":"tmp/playbook-sdk_1.2.0_1792065335403_0.7997837340971019","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"_id":"playbook-sdk@1.3.0","bugs":{"url":"https://github.com/playbook-labs/playbook-sdk/issues"},"dist":{"shasum":"6b408a6b8d26501b1111847c4522f811af3b3c9e","tarball":"https://registry.npmjs.org/playbook-sdk/-/playbook-sdk-1.3.0.tgz","fileCount":18,"integrity":"sha512-eLDwa/wxSGTXEHQWLZYdM4k+PEyWvz0H+lMUSRk5No6cvUTRKblw9t3LViI1Q5qGogPw6qEuxUvzU+HTtzIKAA==","signatures":[{"sig":"MEYCIQCLPDhYqEIwcirZNXdIt13pkaJ1hOKphfwqBcHLhDQ55gIhAL3zdpwIjhTOV5IoVpSczfOQjg3eptRaK8k/qB/C0uel","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDOcTDyaJWq7ZhRCTADt1sb2VQ0yG5Tw3dd848zCGON0AiEA0dgmX7DA2PudoIcdxEd99Vh0A1KwJKHFTDnAtbdRDPU="}],"unpackedSize":236460},"main":"dist/playbook-sdk.min.js","name":"playbook-sdk","types":"index.d.ts","unpkg":"dist/playbook-sdk.min.js","author":{"name":"Playbook Labs","email":"support@playbook.com"},"module":"dist/playbook-sdk.min.js","browser":"dist/playbook-sdk.min.js","engines":{"node":">=12.0.0"},"exports":{".":{"types":"./index.d.ts","default":"./dist/playbook-sdk.min.js"},"./embed":{"types":"./index.d.ts","default":"./dist/playbook-embed.min.js"},"./picker":{"types":"./index.d.ts","default":"./dist/playbook-picker.min.js"},"./player":{"types":"./index.d.ts","default":"./dist/playbook-player.min.js"},"./search":{"types":"./index.d.ts","default":"./dist/playbook-search.min.js"},"./viewer":{"types":"./index.d.ts","default":"./dist/playbook-viewer.min.js"},"./uploader":{"types":"./index.d.ts","default":"./dist/playbook-uploader.min.js"}},"gitHead":"dfe478e6388374f8daddbbb659286eca16a4bccd","license":"MIT","scripts":{"test":"node --test","build":"node build.mjs","prepublishOnly":"npm run build && npm test"},"typings":"index.d.ts","version":"1.3.0","_npmUser":{"name":"playbook-labs","email":"developers@playbook.com"},"homepage":"https://github.com/playbook-labs/playbook-sdk#readme","jsdelivr":"dist/playbook-sdk.min.js","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"repository":{"url":"git+https://github.com/playbook-labs/playbook-sdk.git","type":"git"},"_npmVersion":"11.19.1","description":"A lightweight, zero-dependency frontend SDK for embedding beautiful, searchable media galleries backed by the Playbook API","directories":{},"maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"_nodeVersion":"24.22.2","_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.24.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/playbook-sdk_1.3.0_1794320399314_0.20747566653328686"}}},"time":{"created":"2025-11-28T22:05:52.261Z","modified":"2026-11-10T14:19:59.626Z","1.0.0":"2025-11-27T15:44:03.768Z","1.0.1":"2025-11-28T22:05:52.468Z","1.0.2":"2025-11-28T22:09:44.770Z","1.0.3":"2025-12-01T16:40:28.143Z","1.0.4":"2026-10-02T14:39:46.091Z","1.1.0":"2026-10-02T14:44:25.610Z","1.2.0":"2026-10-15T11:55:35.486Z","1.3.0":"2026-11-10T14:19:59.436Z"},"bugs":{"url":"https://github.com/playbook-labs/playbook-sdk/issues"},"author":{"name":"Playbook Labs","email":"support@playbook.com"},"license":"MIT","homepage":"https://github.com/playbook-labs/playbook-sdk#readme","keywords":["gallery","masonry","grid","assets","images","sdk","component","frontend","ui","responsive","modal","lightbox","media-library","typescript","react","vue","angular"],"repository":{"url":"git+https://github.com/playbook-labs/playbook-sdk.git","type":"git"},"description":"A lightweight, zero-dependency frontend SDK for embedding beautiful, searchable media galleries backed by the Playbook API","maintainers":[{"name":"playbook-labs","email":"developers@playbook.com"}],"readme":"# Playbook Gallery SDK\n\nA lightweight frontend SDK for creating masonry grid galleries with search, board navigation, and modal views. Works for asset management, photo galleries, and media libraries.\n\n![Version](https://img.shields.io/npm/v/playbook-sdk.svg?color=blue)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n![Size](https://img.shields.io/badge/size-~7kB%20gzipped-orange.svg)\n\n![SDK UI](https://img.playbook.com/W-co81i7JEeSq21dvhvERZ30YSXyXrAiN37FRE6LctI/s:800:677/Z3M6Ly9wbGF5Ym9v/ay1hc3NldHMtcHVi/bGljL2QxZTc0YTI0/LWM4OTQtNDcwMS1h/NzllLTNiYmQ3YjA3/M2VjYw)\n\n## Features\n\n- Fully responsive - adapts from 2 to 8 columns based on screen size\n- Search with AI toggle - regular and semantic search\n- Board navigation - organize assets into categories\n- Modal viewer - full-screen asset view with keyboard navigation\n- Download support - one-click downloads\n- Customizable - extensive configuration options\n- Framework agnostic - works with vanilla JS, React, Vue, Angular\n- Zero dependencies\n- TypeScript support\n- Accessible - ARIA labels and keyboard navigation\n- Lightweight - ~31KB minified (~7KB gzipped)\n\n## Installation\n\n### Option 1: CDN (Quickest)\n\n```html\n<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>My Gallery</title>\n\n    <!-- Optional: Include Tailwind CSS for styling -->\n    <script src=\"https://cdn.tailwindcss.com\"></script>\n  </head>\n  <body>\n    <!-- Your gallery container -->\n    <div id=\"my-gallery\"></div>\n\n    <!-- Include Playbook SDK -->\n    <script src=\"https://unpkg.com/playbook-sdk@latest/dist/playbook-sdk.min.js\"></script>\n\n    <script>\n      // Initialize your gallery\n      const gallery = PlaybookSDK.init({\n        containerId: \"my-gallery\",\n        organizationSlug: \"your-org-slug\",\n        getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n      });\n    </script>\n  </body>\n</html>\n```\n\n### Option 2: npm\n\n```bash\nnpm install playbook-sdk\n```\n\n```javascript\nimport PlaybookSDK from \"playbook-sdk\";\n\nconst gallery = PlaybookSDK.init({\n  containerId: \"my-gallery\",\n  organizationSlug: \"your-org-slug\",\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n});\n```\n\n### Option 3: Download\n\nDownload `playbook-sdk.min.js` and include it in your project:\n\n```html\n<script src=\"path/to/playbook-sdk.min.js\"></script>\n```\n\n## Quick Start\n\n### 1. Set Up Authentication\n\nThe gallery runs in your visitors' browsers, so it must never be given your API token: anyone can read it from the page. Instead, your server exchanges that token for a short-lived, read-only one limited to a single board, and the SDK fetches it from your server through `getAccessToken`.\n\n1. Create an API token in the Playbook app under **Developer → SDK** at [playbook.com](https://www.playbook.com/sign-up?navigateTo=sdk) (no approval step required). Keep it on your server.\n2. Add an endpoint to your server that calls `POST https://api.playbook.com/v1/{organizationSlug}/access_tokens` with that token and the `board_token` to expose, and returns `data.access_token` from the response. [`examples/backend/token-server.mjs`](examples/backend/token-server.mjs) is a complete, dependency-free version.\n3. Point `getAccessToken` at that endpoint. The examples below assume it lives at `/playbook/token` and answers `{ \"token\": \"...\" }`.\n\nThe SDK calls `getAccessToken` before its first request and again when the token expires, and keeps the token in memory only. The token can read the board it was created for and that board's sub-boards, nothing else, for at most an hour.\n\nYou'll also need:\n\n- **Organization Slug** (e.g., `playbook-sdk`)\n- **Board ID** (optional) — the board the access token was created for, or one of its sub-boards\n\n### 2. Create HTML Container\n\n```html\n<div id=\"gallery-container\"></div>\n```\n\n### 3. Initialize SDK\n\n```javascript\nconst gallery = PlaybookSDK.init({\n  containerId: \"gallery-container\",\n  organizationSlug: \"playbook-sdk\", // Your organization/workspace slug\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n  boardId: \"\", // Optional: Scope gallery to specific board\n  enableSearch: true,\n  enableBoards: true,\n  enableModal: true,\n});\n```\n\n### 4. Done\n\nThe SDK will fetch and display your assets from Playbook.\n\n## Configuration Options\n\n```javascript\nPlaybookSDK.init({\n  // ===== Required =====\n  containerId: \"my-gallery\", // ID of the container element\n  organizationSlug: \"your-org-slug\", // Your Playbook workspace slug\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n\n  // ===== Optional Scoping =====\n  boardId: \"\", // Scope to specific board (empty = everything the access token can read)\n  // When boardId is set:\n  // - \"All Assets\" shows only assets from this board + nested boards\n  // - Board navigation shows only children of this board\n  // - Users cannot navigate outside this board tree\n  // - Search covers only this board + nested boards\n\n  // ===== Features =====\n  enableSearch: true, // Show search bar with AI toggle\n  enableBoards: true, // Show board/collection navigation\n  enableModal: true, // Enable full-screen asset viewer\n  enableDownload: true, // Show download button in modal\n  enableInfo: true, // Show info button in modal\n\n  // ===== Responsive Columns =====\n  columnBreakpoints: {\n    default: 2, // Mobile (< 768px)\n    768: 3, // Tablet\n    1024: 4, // Desktop\n    1280: 5, // Large desktop\n    1536: 6, // XL screens\n    1800: 7, // 2XL screens\n    2000: 8, // Ultra-wide\n  },\n\n  // ===== Styling =====\n  theme: \"light\", // 'light' or 'dark' (future)\n  customStyles: {}, // Custom CSS overrides\n\n  // ===== Callbacks =====\n  onAssetClick: function (asset) {\n    console.log(\"Asset clicked:\", asset);\n  },\n\n  onSearch: function (query) {\n    console.log(\"Search performed:\", query);\n  },\n\n  onBoardChange: function (boardId, boardTitle) {\n    console.log(\"Board changed:\", boardTitle || boardId);\n  },\n\n  onModalOpen: function (asset) {\n    console.log(\"Modal opened:\", asset);\n  },\n\n  onModalClose: function () {\n    console.log(\"Modal closed\");\n  },\n\n  onDownload: function (asset) {\n    console.log(\"Asset downloaded:\", asset);\n  },\n});\n```\n\n### Examples\n\n**Everything the access token can read:**\n\n```javascript\nPlaybookSDK.init({\n  containerId: \"gallery\",\n  organizationSlug: \"acme-corp\",\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n  boardId: \"\", // Empty = the token's board and its sub-boards\n});\n```\n\n**Board-scoped gallery:**\n\n```javascript\nPlaybookSDK.init({\n  containerId: \"gallery\",\n  organizationSlug: \"acme-corp\",\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n  boardId: \"SddGjNcAFZThZb3yVTSvbGbe\", // Only this board + children\n});\n```\n\n## Usage Examples\n\n### Basic Implementation\n\n```html\n<!DOCTYPE html>\n<html>\n  <head>\n    <title>My Asset Gallery</title>\n    <script src=\"https://cdn.tailwindcss.com\"></script>\n  </head>\n  <body class=\"bg-gray-100 p-8\">\n    <div class=\"max-w-7xl mx-auto\">\n      <h1 class=\"text-4xl font-bold mb-8\">Asset Library</h1>\n      <div id=\"gallery\"></div>\n    </div>\n\n    <script src=\"playbook-sdk.min.js\"></script>\n    <script>\n      PlaybookSDK.init({\n        containerId: \"gallery\",\n        organizationSlug: \"my-company\",\n        getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n      });\n    </script>\n  </body>\n</html>\n```\n\n### With Callbacks\n\n```javascript\nconst gallery = PlaybookSDK.init({\n  containerId: \"gallery\",\n  organizationSlug: \"my-company\",\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n\n  onAssetClick: function (asset) {\n    // Track analytics\n    gtag(\"event\", \"asset_view\", {\n      asset_id: asset.token,\n      asset_name: asset.title,\n    });\n  },\n\n  onSearch: function (query) {\n    // Track search\n    console.log(\"User searched for:\", query);\n  },\n\n  onBoardChange: function (boardId, boardTitle) {\n    // Track board navigation\n    console.log(\"Navigated to:\", boardTitle);\n  },\n\n  onDownload: function (asset) {\n    // Track downloads\n    gtag(\"event\", \"asset_download\", {\n      asset_id: asset.token,\n    });\n  },\n});\n```\n\n### Custom Column Configuration\n\n```javascript\nPlaybookSDK.init({\n  containerId: \"gallery\",\n  organizationSlug: \"my-company\",\n  getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n\n  // Custom breakpoints for your design\n  columnBreakpoints: {\n    default: 1, // 1 column on mobile\n    640: 2, // 2 columns on small tablets\n    1024: 3, // 3 columns on desktop\n    1440: 4, // 4 columns on large screens\n  },\n});\n```\n\n### React Integration\n\n```jsx\nimport { useEffect, useRef } from \"react\";\nimport PlaybookSDK from \"playbook-sdk\";\n\nfunction GalleryComponent() {\n  const galleryRef = useRef(null);\n  const sdkInstance = useRef(null);\n\n  useEffect(() => {\n    if (galleryRef.current && !sdkInstance.current) {\n      sdkInstance.current = PlaybookSDK.init({\n        containerId: \"react-gallery\",\n        organizationSlug: \"your-org-slug\",\n        getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n\n        onAssetClick: (asset) => {\n          console.log(\"Asset clicked:\", asset);\n        },\n      });\n    }\n\n    return () => {\n      if (sdkInstance.current) {\n        PlaybookSDK.destroy(\"react-gallery\");\n        sdkInstance.current = null;\n      }\n    };\n  }, []);\n\n  return <div id='react-gallery' ref={galleryRef} />;\n}\n\nexport default GalleryComponent;\n```\n\n### TypeScript Integration\n\nTypeScript definitions included:\n\n```typescript\nimport PlaybookSDK, {\n  PlaybookConfig,\n  GalleryInstance,\n  Asset,\n  Board,\n} from \"playbook-sdk\";\nimport { useEffect, useRef } from \"react\";\n\nfunction TypeScriptGallery() {\n  const sdkInstance = useRef<GalleryInstance | null>(null);\n\n  useEffect(() => {\n    const config: PlaybookConfig = {\n      containerId: \"ts-gallery\",\n      organizationSlug: \"your-org-slug\",\n      getAccessToken: () => fetch(\"/playbook/token\").then((r) => r.json()).then((r) => r.token),\n      enableSearch: true,\n      enableBoards: true,\n\n      onAssetClick: (asset: Asset) => {\n        console.log(\"Asset clicked:\", asset.title);\n      },\n\n      onBoardChange: (boardId: string, boardTitle: string) => {\n        console.log(\"Board changed:\", boardTitle);\n      },\n    };\n\n    sdkInstance.current = PlaybookSDK.init(config);\n\n    return () => {\n      if (sdkInstance.current) {\n        PlaybookSDK.destroy(\"ts-gallery\");\n      }\n    };\n  }, []);\n\n  return <div id='ts-gallery' />;\n}\n```\n\n## Public API Methods\n\nInteract with the gallery instance:\n\n```javascript\nconst gallery = PlaybookSDK.init({\n  /* config */\n});\n\n// Refresh the gallery\ngallery.refresh();\n\n// Programmatically search\ngallery.search(\"logo\");\n\n// Select a specific board\ngallery.selectBoardById(\"brand-assets\");\n\n// Get current assets\nconst assets = gallery.getAssets();\n\n// Destroy the gallery\ngallery.destroy();\n\n// Get gallery instance later\nconst instance = PlaybookSDK.getInstance(\"my-gallery\");\n```\n\n## Uploader\n\nA drag-and-drop uploader ships as its own bundle\n(`dist/playbook-uploader.min.js`, global `PlaybookUploader`, or\n`import PlaybookUploader from \"playbook-sdk/uploader\"`). It never takes a write\ntoken in the browser: your backend prepares and completes each upload. See\n[docs/uploader.md](docs/uploader.md).\n\n## Styling & Customization\n\nCSS classes are prefixed with `pb-` to avoid conflicts:\n\n```css\n/* Override styles in your CSS */\n.pb-masonry-item img {\n  border-radius: 12px !important;\n  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2) !important;\n}\n\n.pb-board-btn.active {\n  background-color: #your-brand-color !important;\n}\n\n.pb-modal-content {\n  border-radius: 20px !important;\n}\n```\n\n## Keyboard Shortcuts\n\nModal controls:\n\n- `←` Previous asset\n- `→` Next asset\n- `Esc` Close modal\n\n## More Components\n\nThe package also ships a media picker, an inline video player, a single asset\nembed and a headless search box, each as its own bundle. See\n[docs/components.md](docs/components.md).\n\n## Browser Support\n\n- Chrome/Edge (latest)\n- Firefox (latest)\n- Safari (latest)\n- Mobile browsers (iOS Safari, Chrome Mobile)\n\n## Support\n\nFor issues and questions:\n\n- Documentation: [Developer Portal](https://dev.playbook.com)\n- Email: [support@playbook.com](mailto:support@playbook.com)\n\n## Roadmap\n\n- [ ] Dark theme support\n- [x] Video preview in grid\n- [x] Drag & drop upload\n- [ ] Batch download\n- [x] Grid/List view toggle\n- [x] Advanced filtering\n- [x] Asset metadata display\n- [ ] Lazy loading optimization\n","readmeFilename":"README.md"}