個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
在專案資料夾中執行 /nomorevibe verify,即可驗證所有權並自行管理介紹。
一分鐘完成驗證Album-first personal music library.
翻譯準備中
取自儲存庫 README
正在載入完整 README。 以下為已儲存的摘錄。
Bricola builds a cover cloud from Spotify or a listening-history export. Hover a cover to hear a short snippet.
This is not a library player. Items without a matched, playable preview never enter the cloud.
Agent UI rules live in AGENTS.md. Branch and brand policy live under .cursor/rules/.
Open http://127.0.0.1:43217. Use that host, not localhost. See docs/setup.md.
Spotify is optional. Without it, use manual upload or See an example.檢視完整 README ↗Bricola builds a cover cloud from Spotify or a listening-history export. Hover a cover to hear a short snippet.
This is not a library player. Items without a matched, playable preview never enter the cloud.
| Doc | Use it for |
|---|---|
| docs/README.md | Doc index |
| docs/product.md | Product intent and journeys |
| docs/setup.md | Local install and env |
| docs/architecture.md | Stack, data flow, APIs |
| docs/contributing.md | Branches, PRs, conventions |
| docs/ops.md | Deploy and releases |
| docs/roadmap.md | Unshipped ideas |
| docs/testing.md | E2E layout and how to run tests |
| CHANGELOG.md | Released changes |
Agent UI rules live in AGENTS.md. Branch and brand policy live under .cursor/rules/.
npm install
cp .env.example .env.local
npm run dev
Open http://127.0.0.1:43217. Use that host, not localhost. See docs/setup.md.
Spotify is optional. Without it, use manual upload or See an example.
| Script | Purpose |
|---|---|
npm run dev | Dev server on 0.0.0.0:43217 |
npm run build | Production build |
npm start | Serve the production build |
npm run lint | ESLint |
npm run astryx:check | Astryx doctor + theme artifact check |
npm run lint:astryx-interim | Interim Astryx ESLint (see docs/astryx-ci.md) |
npm run astryx:review | Design System Reviewer (--dry-run) |
npm run theme:build | Build the Bricola Astryx theme CSS |
npm run theme:check | Fail if theme artifacts are stale |
npm run test:e2e | Playwright E2E (headless) |
npm run test:e2e:ui | Playwright UI mode |
npm run test:e2e:install | Install Chromium for Playwright |
Album clouds can rotate up to three snippets per cover. Track clouds play one snippet per cover.
Snippets fade in and out. Deezer clips re-resolve on play so short-lived CDN tokens do not leave silent covers.
Playwright E2E regression: npm run test:e2e (see docs/testing.md for layout, coverage, and planned unit tests).
The GitHub repository is named music-cloud. That is the repo name only. The product name is Bricola.