mirror of
https://github.com/nomadkaraoke/karaoke-gen.git
synced 2026-11-20 13:07:57 +09:00
feat: add Singa whitelabel tenant and fix tenant infrastructure (#453)
## Summary - Add Singa as second whitelabel tenant (green/black branding, file-upload-only, locked theme) - Fix critical Zustand getter bug where computed properties became stale after set() calls - Fix React hydration error #300 (conditional return between hooks) - Add TenantLandingPage component for minimal tenant portal - Add Cloudflare Pages cache control headers - Add gs:// URL conversion fallback in tenant-logo ## Test plan - 27 tenant unit tests pass (5 new regression tests for Zustand bug) - 181 E2E tests pass - Verified singa/vocalstar/gen domains all working correctly <!-- @coderabbitai ignore --> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
e788187351
commit
2615261672
13 files changed
+1072
-53
No files matched your search
@@ -9,7 +9,6 @@ on:
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
pages: write
|
||||
id-token: write
|
||||
|
||||
concurrency:
|
||||
@@ -869,7 +868,7 @@ jobs:
|
||||
|
||||
### Assets
|
||||
- Python package published to PyPI
|
||||
- Frontend deployed to GitHub Pages at gen.nomadkaraoke.com
|
||||
- Frontend deployed to Cloudflare Pages at gen.nomadkaraoke.com
|
||||
|
||||
For detailed changes, see the commit history.
|
||||
draft: false
|
||||
@@ -879,7 +878,7 @@ jobs:
|
||||
dist/*.tar.gz
|
||||
|
||||
deploy-frontend:
|
||||
name: "Deploy - Frontend (GitHub Pages)"
|
||||
name: "Deploy - Frontend (Cloudflare Pages)"
|
||||
runs-on: ubuntu-latest
|
||||
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
|
||||
steps:
|
||||
@@ -910,17 +909,12 @@ jobs:
|
||||
NEXT_PUBLIC_API_URL: https://api.nomadkaraoke.com
|
||||
run: npm run build
|
||||
|
||||
- name: Setup Pages
|
||||
uses: actions/configure-pages@v4
|
||||
|
||||
- name: Upload artifact
|
||||
uses: actions/upload-pages-artifact@v3
|
||||
- name: Deploy to Cloudflare Pages
|
||||
uses: cloudflare/wrangler-action@v3
|
||||
with:
|
||||
path: "frontend/out"
|
||||
|
||||
- name: Deploy to GitHub Pages
|
||||
id: deployment
|
||||
uses: actions/deploy-pages@v4
|
||||
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
|
||||
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
|
||||
command: pages deploy frontend/out --project-name=karaoke-gen --branch=main
|
||||
|
||||
# NOTE: buy-site was consolidated into the main frontend (PR #122, Dec 2024)
|
||||
# Landing page and payment flow are now at gen.nomadkaraoke.com (root)
|
||||
|
||||
@@ -443,15 +443,22 @@ if tenant_config and not tenant_config.features.audio_search:
|
||||
raise HTTPException(403, "Audio search not enabled for this tenant")
|
||||
```
|
||||
|
||||
### First Tenant: Vocal Star
|
||||
### Active Tenants
|
||||
|
||||
- Subdomain: `vocalstar.nomadkaraoke.com`
|
||||
**Vocal Star** (`vocalstar.nomadkaraoke.com`)
|
||||
- Features: File upload only (no audio search, no YouTube URL)
|
||||
- Distribution: Download only (no YouTube/Dropbox/GDrive)
|
||||
- Theme: Locked to "vocalstar" theme (yellow/blue)
|
||||
- Auth: Restricted to `@vocal-star.com` and `@vocalstarmusic.com` emails
|
||||
- Setup: `python scripts/setup-vocalstar-tenant.py`
|
||||
|
||||
**Singa** (`singa.nomadkaraoke.com`)
|
||||
- Features: File upload only (no audio search, no YouTube URL)
|
||||
- Distribution: Download only
|
||||
- Theme: Locked to "singa" theme (green/black)
|
||||
- Auth: Restricted to `@singa.com` emails
|
||||
- Setup: `python scripts/setup-singa-tenant.py`
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **Backend**: FastAPI, Python 3.12, Cloud Run
|
||||
|
||||
@@ -57,6 +57,30 @@ When two sequential human review steps can be combined into one, do it. We origi
|
||||
|
||||
**Pattern**: Treat resource IDs (brand codes, sequential IDs) like distributed transactions — either all distribution points are cleaned, or the ID stays reserved.
|
||||
|
||||
### Never Use JavaScript Getters in Zustand Stores (Mar 2026)
|
||||
**What happened**: Tenant branding, features, and defaults always returned initial defaults instead of loaded tenant data. The Singa portal showed the Nomad Karaoke pink theme and default logo instead of Singa's green branding.
|
||||
|
||||
**Root cause**: The Zustand store defined computed values as JavaScript `get` property descriptors:
|
||||
```typescript
|
||||
// BROKEN - getter destroyed by Zustand's set() internals
|
||||
const useStore = create((set, get) => ({
|
||||
tenant: null,
|
||||
get branding() { return get().tenant?.branding ?? DEFAULT_BRANDING },
|
||||
}))
|
||||
```
|
||||
When Zustand calls `set()`, it uses `Object.assign({}, currentState, partialUpdate)`. `Object.assign` **invokes** getters and copies their return **values** as plain properties. After the first `set({ isLoading: true })`, `branding` became a frozen static copy of `DEFAULT_BRANDING` — all subsequent state updates were invisible to it.
|
||||
|
||||
**Fix**: Move computed values outside the store. Use standalone functions that compute from state on each access:
|
||||
```typescript
|
||||
function getBranding(state) { return state.tenant?.branding ?? DEFAULT_BRANDING }
|
||||
export function useTenant() {
|
||||
const store = useTenantStore()
|
||||
return { ...store, branding: getBranding(store) }
|
||||
}
|
||||
```
|
||||
|
||||
**Pattern**: Never use `get` property descriptors in objects that will be spread or `Object.assign`'d. Zustand, Redux, and other state libraries that merge objects will silently destroy getters. Use wrapper functions or selector hooks instead.
|
||||
|
||||
### Fail Fast, Don't Fall Back
|
||||
Silent fallbacks hide configuration errors. When critical configuration is missing (themes, credentials, etc.), raise clear errors instead of falling back to defaults. Better to fail loudly during testing than silently produce incorrect output in production. Example: Theme validation (v0.109.0) now raises `ValueError` on incomplete themes instead of merging with defaults. This ensures all cloud jobs use complete, explicit themes with no silent degradation.
|
||||
|
||||
|
||||
+3
-1
@@ -29,7 +29,7 @@
|
||||
| Rate limiting & abuse prevention | Working |
|
||||
| CI/CD self-hosted runner | Working (GCP) |
|
||||
| E2E happy path test | Working (~20-25 min full pipeline) |
|
||||
| **White-label B2B portals** | Working (Vocal Star first tenant) |
|
||||
| **White-label B2B portals** | Working (Vocal Star, Singa) |
|
||||
| **Private (non-published) tracks** | Working |
|
||||
| **Song lookup autocomplete** | Working (via karaoke-decide catalog) |
|
||||
| **Community version detection** | Working (via karaokenerds.com) |
|
||||
@@ -44,6 +44,8 @@
|
||||
|
||||
## Recent Changes
|
||||
|
||||
- **Singa Whitelabel Tenant** (2026-03-03): Added Singa (singa.com) as second B2B tenant. Green/black branding, file-upload-only mode, locked to "singa" theme, restricted to @singa.com emails. Setup script generates all branding assets (4K backgrounds, CDG backgrounds, logo) programmatically with Pillow. Also fixed critical Zustand getter bug where computed store properties (branding, features, defaults) became stale static values after any `set()` call — `Object.assign` invokes getters and copies return values, destroying the getter. Added `TenantLandingPage` component for minimal tenant portal experience (logo + sign-in). Added Cloudflare Pages `_headers` for proper cache control. See [LESSONS-LEARNED.md](LESSONS-LEARNED.md#never-use-javascript-getters-in-zustand-stores-mar-2026).
|
||||
|
||||
- **Song Lookup Autocomplete & Community Version Detection** (2026-03-03): Added song catalog integration to the job creation flow. Two features: (1) **Track autocomplete** on the title field provides canonical artist/title names from MusicBrainz + Spotify data via the karaoke-decide catalog API, improving text consistency for YouTube releases. Autocomplete activates when the artist field has a value; selecting a suggestion overwrites both artist and title with canonical names. (2) **Community version detection** checks karaokenerds.com for existing high-quality karaoke versions — if found, a dismissible green banner suggests the user check those versions first before spending credits. New backend: 3 endpoints (`/api/catalog/artists`, `/api/catalog/tracks`, `/api/catalog/community-check`) with per-user rate limiting (20 req/min) and in-memory TTL caching. New services: `catalog_proxy_service.py` (proxies to karaoke-decide), `karaokenerds_service.py` (scrapes karaokenerds.com). New frontend components: `AutocompleteInput` (reusable), `CommunityVersionBanner`. See [API.md](API.md#catalog-song-lookup).
|
||||
|
||||
- **Feedback-for-Credits** (2026-03-01): Added a feedback-for-credits mechanism available to all users (replaces the old beta-only feedback flow). Users who complete 2+ karaoke videos can submit product feedback (star ratings + text) to earn 2 free credits (total possible free credits: 4 — 2 welcome + 2 feedback). New endpoints: `GET /api/users/feedback/eligibility`, `POST /api/users/feedback`. The `/api/users/me` response includes `feedback_eligible: bool` so the frontend can show/hide prompts without an extra API call. Frontend shows a dismissible banner on the dashboard and a "Earn 2 Free Credits" menu item in the user dropdown when eligible. Feedback stored in `user_feedback` Firestore collection with duplicate prevention via `has_submitted_feedback` flag on user model. Welcome email updated with credit-focused messaging and feedback teaser. See [API.md](API.md#user-feedback-for-credits).
|
||||
|
||||
@@ -23,6 +23,8 @@ import { api, setAccessToken, getAccessToken, CreditPackage } from '@/lib/api';
|
||||
import { AuthDialog } from '@/components/auth/AuthDialog';
|
||||
import { WarmingUpLoader } from '@/components/WarmingUpLoader';
|
||||
import { ThemeToggle } from '@/components/ThemeToggle';
|
||||
import { useTenant } from '@/lib/tenant';
|
||||
import { TenantLandingPage } from '@/components/TenantLandingPage';
|
||||
|
||||
// FAQ data
|
||||
const faqs = [
|
||||
@@ -55,7 +57,9 @@ const faqs = [
|
||||
|
||||
export default function LandingPage() {
|
||||
const router = useRouter();
|
||||
const { isDefault: isDefaultTenant, isLoading: tenantLoading, isInitialized: tenantInitialized } = useTenant();
|
||||
const [isCheckingAuth, setIsCheckingAuth] = useState(true);
|
||||
const [isMounted, setIsMounted] = useState(false);
|
||||
const [packages, setPackages] = useState<CreditPackage[]>([]);
|
||||
const [packagesLoading, setPackagesLoading] = useState(true);
|
||||
const [packagesError, setPackagesError] = useState<string | null>(null);
|
||||
@@ -77,6 +81,11 @@ export default function LandingPage() {
|
||||
// Auth dialog state
|
||||
const [showAuthDialog, setShowAuthDialog] = useState(false);
|
||||
|
||||
// Track client-side mount to avoid hydration mismatch
|
||||
useEffect(() => {
|
||||
setIsMounted(true);
|
||||
}, []);
|
||||
|
||||
// Check if already logged in and redirect to app
|
||||
useEffect(() => {
|
||||
const token = getAccessToken();
|
||||
@@ -114,6 +123,13 @@ export default function LandingPage() {
|
||||
loadPackages();
|
||||
}, [isCheckingAuth]);
|
||||
|
||||
// Tenant portals get a minimal landing page (just logo + sign in)
|
||||
// Only check after mount to avoid hydration mismatch with static export
|
||||
// Must be AFTER all hooks to comply with React Rules of Hooks
|
||||
if (isMounted && tenantInitialized && !isDefaultTenant) {
|
||||
return <TenantLandingPage />;
|
||||
}
|
||||
|
||||
// Handle checkout
|
||||
const handleCheckout = async (e: React.FormEvent) => {
|
||||
e.preventDefault();
|
||||
|
||||
@@ -0,0 +1,115 @@
|
||||
'use client'
|
||||
|
||||
import { useState } from 'react'
|
||||
import { useRouter } from 'next/navigation'
|
||||
import { TenantLogo } from '@/components/tenant-logo'
|
||||
import { AuthDialog } from '@/components/auth/AuthDialog'
|
||||
import { useTenant } from '@/lib/tenant'
|
||||
import { ThemeToggle } from '@/components/ThemeToggle'
|
||||
|
||||
/**
|
||||
* Minimal landing page for whitelabel tenant portals.
|
||||
* Shows tenant logo, brief description, and sign-in button.
|
||||
* No pricing, marketing content, or payment options.
|
||||
*/
|
||||
export function TenantLandingPage() {
|
||||
const router = useRouter()
|
||||
const { tenant, branding } = useTenant()
|
||||
const [showAuthDialog, setShowAuthDialog] = useState(false)
|
||||
|
||||
const handleAuthSuccess = () => {
|
||||
setShowAuthDialog(false)
|
||||
router.push('/app')
|
||||
}
|
||||
|
||||
const tenantName = tenant?.name || 'Partner'
|
||||
const primaryColor = branding.primary_color || '#ff7acc'
|
||||
|
||||
return (
|
||||
<div
|
||||
className="min-h-screen flex flex-col"
|
||||
style={{ backgroundColor: branding.background_color || '#000000' }}
|
||||
>
|
||||
{/* Header */}
|
||||
<header className="w-full px-6 py-4 flex items-center justify-between">
|
||||
<div className="w-8" /> {/* Spacer for centering */}
|
||||
<div /> {/* Center empty */}
|
||||
<div className="flex items-center gap-3">
|
||||
<ThemeToggle />
|
||||
</div>
|
||||
</header>
|
||||
|
||||
{/* Main content - centered */}
|
||||
<main className="flex-1 flex flex-col items-center justify-center px-6 -mt-16">
|
||||
{/* Tenant logo */}
|
||||
<div className="mb-8">
|
||||
<TenantLogo size="lg" className="mx-auto" />
|
||||
</div>
|
||||
|
||||
{/* Title */}
|
||||
<h1 className="text-2xl md:text-3xl font-semibold text-center mb-3" style={{ color: '#ffffff' }}>
|
||||
Karaoke Generator for{' '}
|
||||
<span style={{ color: primaryColor }}>{tenantName}</span>
|
||||
</h1>
|
||||
|
||||
{/* Tagline */}
|
||||
{branding.tagline && (
|
||||
<p className="text-muted-foreground text-center text-lg mb-10 max-w-md">
|
||||
{branding.tagline}
|
||||
</p>
|
||||
)}
|
||||
|
||||
{!branding.tagline && (
|
||||
<p className="text-muted-foreground text-center text-lg mb-10 max-w-md">
|
||||
Create professional karaoke videos with real instrumentals, precise lyrics sync, and 4K output.
|
||||
</p>
|
||||
)}
|
||||
|
||||
{/* Sign in button */}
|
||||
<button
|
||||
onClick={() => setShowAuthDialog(true)}
|
||||
className="px-8 py-3 rounded-lg text-lg font-semibold transition-all hover:opacity-90 cursor-pointer"
|
||||
style={{
|
||||
backgroundColor: primaryColor,
|
||||
color: branding.background_color || '#000000',
|
||||
}}
|
||||
>
|
||||
Sign In
|
||||
</button>
|
||||
|
||||
{/* Domain hint */}
|
||||
{(() => {
|
||||
const externalDomains = tenant?.allowed_email_domains?.filter(d => d !== 'nomadkaraoke.com') ?? []
|
||||
if (externalDomains.length === 0) return null
|
||||
return (
|
||||
<p className="text-muted-foreground text-sm mt-4">
|
||||
Sign in with your {externalDomains.map(d => `@${d}`).join(' or ')} email
|
||||
</p>
|
||||
)
|
||||
})()}
|
||||
</main>
|
||||
|
||||
{/* Footer */}
|
||||
<footer className="w-full px-6 py-6 text-center">
|
||||
<p className="text-muted-foreground text-xs">
|
||||
Powered by{' '}
|
||||
<a
|
||||
href="https://gen.nomadkaraoke.com"
|
||||
className="underline hover:text-foreground transition-colors"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
>
|
||||
Nomad Karaoke
|
||||
</a>
|
||||
</p>
|
||||
</footer>
|
||||
|
||||
{/* Auth dialog */}
|
||||
<AuthDialog
|
||||
open={showAuthDialog}
|
||||
onClose={() => setShowAuthDialog(false)}
|
||||
onSuccess={handleAuthSuccess}
|
||||
/>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -20,7 +20,16 @@ export function TenantLogo({ className = "", size = "sm" }: TenantLogoProps) {
|
||||
const { tenant, branding, isDefault } = useTenant()
|
||||
|
||||
// Determine logo URL and dimensions
|
||||
const logoUrl = branding.logo_url || DEFAULT_LOGO_URL
|
||||
// Convert gs:// URLs to the API asset endpoint
|
||||
let logoUrl = branding.logo_url || DEFAULT_LOGO_URL
|
||||
if (logoUrl.startsWith("gs://") && tenant?.id) {
|
||||
const filename = logoUrl.split("/").pop()
|
||||
if (filename) {
|
||||
logoUrl = `https://api.nomadkaraoke.com/api/tenant/asset/${tenant.id}/${filename}`
|
||||
} else {
|
||||
logoUrl = DEFAULT_LOGO_URL
|
||||
}
|
||||
}
|
||||
const logoHeight = branding.logo_height || 40
|
||||
|
||||
// Size classes based on size prop - use static Tailwind classes only
|
||||
|
||||
@@ -109,6 +109,20 @@ describe("useTenant store", () => {
|
||||
expect(state.tenant?.branding.site_title).toBe("Vocal Star Karaoke Generator")
|
||||
})
|
||||
|
||||
it("should return tenant branding via computed property after setTenant (regression: Zustand getter bug)", () => {
|
||||
// This tests the computed `branding` property, not `tenant.branding`.
|
||||
// The Zustand getter bug caused Object.assign during set() to convert
|
||||
// getter properties to stale static values, so `state.branding` would
|
||||
// always return DEFAULT_BRANDING even after tenant was loaded.
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
const state = useTenant.getState()
|
||||
// These use the derived `branding` property, not `tenant?.branding`
|
||||
expect(state.branding.primary_color).toBe("#ffff00")
|
||||
expect(state.branding.secondary_color).toBe("#006CF9")
|
||||
expect(state.branding.site_title).toBe("Vocal Star Karaoke Generator")
|
||||
expect(state.branding.tagline).toBe("Professional Karaoke")
|
||||
})
|
||||
|
||||
it("should return default features when no tenant", () => {
|
||||
const state = useTenant.getState()
|
||||
expect(state.features.audio_search).toBe(true)
|
||||
@@ -124,12 +138,52 @@ describe("useTenant store", () => {
|
||||
expect(state.tenant?.features.file_upload).toBe(true)
|
||||
})
|
||||
|
||||
it("should return tenant features via computed property after setTenant (regression: Zustand getter bug)", () => {
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
const state = useTenant.getState()
|
||||
// These use the derived `features` property, not `tenant?.features`
|
||||
expect(state.features.audio_search).toBe(false)
|
||||
expect(state.features.youtube_upload).toBe(false)
|
||||
expect(state.features.file_upload).toBe(true)
|
||||
expect(state.features.enable_cdg).toBe(true)
|
||||
})
|
||||
|
||||
it("should return tenantId when tenant is set via setTenant", () => {
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
const state = useTenant.getState()
|
||||
expect(state.tenant?.id).toBe("vocalstar")
|
||||
})
|
||||
|
||||
it("should return tenantId via computed property after setTenant (regression: Zustand getter bug)", () => {
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
const state = useTenant.getState()
|
||||
// Uses the derived `tenantId` property, not `tenant?.id`
|
||||
expect(state.tenantId).toBe("vocalstar")
|
||||
})
|
||||
|
||||
it("should return correct defaults via computed property after setTenant", () => {
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
const state = useTenant.getState()
|
||||
expect(state.defaults.theme_id).toBe("vocalstar")
|
||||
expect(state.defaults.locked_theme).toBe("vocalstar")
|
||||
expect(state.defaults.distribution_mode).toBe("download_only")
|
||||
})
|
||||
|
||||
it("should return fresh computed values after multiple set() calls (regression: Zustand getter bug)", () => {
|
||||
// The original bug: each set() call would freeze computed values.
|
||||
// After set({isLoading: true}), branding would permanently return defaults.
|
||||
useTenant.setState({ isLoading: true })
|
||||
useTenant.setState({ isLoading: false })
|
||||
useTenant.getState().setTenant(SAMPLE_VOCALSTAR_CONFIG, false)
|
||||
|
||||
const state = useTenant.getState()
|
||||
// After multiple set() calls, computed values must still reflect tenant data
|
||||
expect(state.branding.primary_color).toBe("#ffff00")
|
||||
expect(state.features.audio_search).toBe(false)
|
||||
expect(state.defaults.theme_id).toBe("vocalstar")
|
||||
expect(state.tenantId).toBe("vocalstar")
|
||||
})
|
||||
|
||||
it("should return null tenantId when no tenant", () => {
|
||||
const state = useTenant.getState()
|
||||
expect(state.tenantId).toBeNull()
|
||||
|
||||
+42
-25
@@ -94,18 +94,24 @@ interface TenantStore {
|
||||
error: string | null
|
||||
isInitialized: boolean
|
||||
|
||||
// Computed values (convenience accessors)
|
||||
branding: TenantBranding
|
||||
features: TenantFeatures
|
||||
defaults: TenantDefaults
|
||||
tenantId: string | null
|
||||
|
||||
// Actions
|
||||
fetchTenantConfig: () => Promise<void>
|
||||
setTenant: (tenant: TenantConfig | null, isDefault: boolean) => void
|
||||
clearError: () => void
|
||||
}
|
||||
|
||||
// Derived state helpers (computed outside store to avoid Zustand getter bug
|
||||
// where Object.assign during set() converts getters to stale static values)
|
||||
function getBranding(state: TenantStore): TenantBranding {
|
||||
return state.tenant?.branding ?? DEFAULT_BRANDING
|
||||
}
|
||||
function getFeatures(state: TenantStore): TenantFeatures {
|
||||
return state.tenant?.features ?? DEFAULT_FEATURES
|
||||
}
|
||||
function getDefaults(state: TenantStore): TenantDefaults {
|
||||
return state.tenant?.defaults ?? DEFAULT_DEFAULTS
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect tenant from current URL subdomain.
|
||||
* Returns tenant ID if on a tenant subdomain, null otherwise.
|
||||
@@ -144,7 +150,7 @@ function detectTenantFromUrl(): string | null {
|
||||
return null
|
||||
}
|
||||
|
||||
export const useTenant = create<TenantStore>()((set, get) => ({
|
||||
const useTenantStore = create<TenantStore>()((set, get) => ({
|
||||
// Initial state
|
||||
tenant: null,
|
||||
isDefault: true,
|
||||
@@ -152,24 +158,6 @@ export const useTenant = create<TenantStore>()((set, get) => ({
|
||||
error: null,
|
||||
isInitialized: false,
|
||||
|
||||
// Computed values
|
||||
get branding() {
|
||||
const { tenant } = get()
|
||||
return tenant?.branding ?? DEFAULT_BRANDING
|
||||
},
|
||||
get features() {
|
||||
const { tenant } = get()
|
||||
return tenant?.features ?? DEFAULT_FEATURES
|
||||
},
|
||||
get defaults() {
|
||||
const { tenant } = get()
|
||||
return tenant?.defaults ?? DEFAULT_DEFAULTS
|
||||
},
|
||||
get tenantId() {
|
||||
const { tenant } = get()
|
||||
return tenant?.id ?? null
|
||||
},
|
||||
|
||||
// Actions
|
||||
fetchTenantConfig: async () => {
|
||||
const state = get()
|
||||
@@ -235,6 +223,35 @@ export const useTenant = create<TenantStore>()((set, get) => ({
|
||||
clearError: () => set({ error: null }),
|
||||
}))
|
||||
|
||||
/**
|
||||
* Primary hook for accessing tenant state with derived values.
|
||||
* Consumers get branding/features/defaults computed fresh on each render.
|
||||
*/
|
||||
export function useTenant() {
|
||||
const store = useTenantStore()
|
||||
return {
|
||||
...store,
|
||||
branding: getBranding(store),
|
||||
features: getFeatures(store),
|
||||
defaults: getDefaults(store),
|
||||
tenantId: store.tenant?.id ?? null,
|
||||
}
|
||||
}
|
||||
|
||||
// Expose Zustand API surface for non-hook contexts and tests
|
||||
useTenant.getState = () => {
|
||||
const state = useTenantStore.getState()
|
||||
return {
|
||||
...state,
|
||||
branding: getBranding(state),
|
||||
features: getFeatures(state),
|
||||
defaults: getDefaults(state),
|
||||
tenantId: state.tenant?.id ?? null,
|
||||
}
|
||||
}
|
||||
useTenant.setState = useTenantStore.setState
|
||||
useTenant.subscribe = useTenantStore.subscribe
|
||||
|
||||
/**
|
||||
* Apply tenant branding by setting CSS custom properties.
|
||||
* This allows dynamic theming without changing the stylesheet.
|
||||
|
||||
@@ -0,0 +1,5 @@
|
||||
/*
|
||||
Cache-Control: public, max-age=0, must-revalidate
|
||||
|
||||
/_next/static/*
|
||||
Cache-Control: public, max-age=31536000, immutable
|
||||
@@ -26,7 +26,12 @@ def create_bucket() -> storage.Bucket:
|
||||
uniform_bucket_level_access=True,
|
||||
cors=[
|
||||
storage.BucketCorArgs(
|
||||
origins=["https://gen.nomadkaraoke.com", "http://localhost:3000"],
|
||||
origins=[
|
||||
"https://gen.nomadkaraoke.com",
|
||||
"https://vocalstar.nomadkaraoke.com",
|
||||
"https://singa.nomadkaraoke.com",
|
||||
"http://localhost:3000",
|
||||
],
|
||||
methods=["PUT"],
|
||||
response_headers=["Content-Type"],
|
||||
max_age_seconds=3600,
|
||||
|
||||
Executable
+779
@@ -0,0 +1,779 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Setup script for Singa white-label tenant.
|
||||
|
||||
This script generates all assets programmatically (no external design files needed):
|
||||
1. Downloads Singa's SVG logo and converts to PNG
|
||||
2. Generates 4K backgrounds (3840x2160) using Pillow
|
||||
3. Generates CDG backgrounds (300x216, indexed color GIF)
|
||||
4. Downloads Inter SemiBold font from Google Fonts
|
||||
5. Creates and uploads theme config (style_params.json)
|
||||
6. Creates and uploads tenant config (config.json)
|
||||
7. Updates the theme registry (_metadata.json)
|
||||
8. Prints DNS/Cloudflare setup instructions
|
||||
|
||||
Usage:
|
||||
python scripts/setup-singa-tenant.py
|
||||
|
||||
Requirements:
|
||||
pip install Pillow google-cloud-storage requests cairosvg
|
||||
gcloud auth application-default login
|
||||
"""
|
||||
import io
|
||||
import json
|
||||
import math
|
||||
import sys
|
||||
import tempfile
|
||||
from pathlib import Path
|
||||
|
||||
import requests
|
||||
from PIL import Image, ImageDraw, ImageFilter, ImageFont
|
||||
|
||||
# Add parent to path for imports
|
||||
sys.path.insert(0, str(Path(__file__).parent.parent))
|
||||
|
||||
from google.cloud import storage
|
||||
|
||||
# ─── Constants ────────────────────────────────────────────────────────────────
|
||||
|
||||
TENANT_ID = "singa"
|
||||
THEME_ID = "singa"
|
||||
GCS_BUCKET = "karaoke-gen-storage-nomadkaraoke"
|
||||
|
||||
# Singa brand colors
|
||||
SINGA_GREEN = "#17E87A"
|
||||
SINGA_BLACK = "#000000"
|
||||
SINGA_WHITE = "#FFFFFF"
|
||||
SINGA_DARK_GRAY = "#1A1A1A"
|
||||
|
||||
# RGB tuples
|
||||
GREEN_RGB = (23, 232, 122)
|
||||
BLACK_RGB = (0, 0, 0)
|
||||
WHITE_RGB = (255, 255, 255)
|
||||
DARK_GRAY_RGB = (26, 26, 26)
|
||||
DARK_GREEN_RGB = (0, 80, 50)
|
||||
|
||||
# Local logo path (download from singa.com brand assets manually)
|
||||
SINGA_LOGO_SVG_DEFAULT = Path.home() / "Downloads" / "singa-logo-white.svg"
|
||||
|
||||
# Dimensions
|
||||
VIDEO_4K_WIDTH = 3840
|
||||
VIDEO_4K_HEIGHT = 2160
|
||||
CDG_WIDTH = 300
|
||||
CDG_HEIGHT = 216
|
||||
|
||||
|
||||
# ─── Asset Generation ─────────────────────────────────────────────────────────
|
||||
|
||||
|
||||
def convert_logo(output_dir: Path, svg_path: Path) -> Path:
|
||||
"""Convert Singa SVG logo to PNG."""
|
||||
if not svg_path.exists():
|
||||
print(f" ERROR: Logo SVG not found at {svg_path}")
|
||||
print(f" Download from singa.com brand assets and save to {svg_path}")
|
||||
sys.exit(1)
|
||||
|
||||
svg_data = svg_path.read_bytes()
|
||||
png_path = output_dir / "logo.png"
|
||||
|
||||
# Try cairosvg first for best quality
|
||||
try:
|
||||
import cairosvg
|
||||
|
||||
cairosvg.svg2png(
|
||||
bytestring=svg_data,
|
||||
write_to=str(png_path),
|
||||
output_width=600,
|
||||
background_color="transparent",
|
||||
)
|
||||
print(f" Converted {svg_path.name} to PNG via cairosvg ({png_path.name})")
|
||||
return png_path
|
||||
except ImportError:
|
||||
print(" cairosvg not available, trying rsvg-convert...")
|
||||
|
||||
# Fallback: try rsvg-convert (available via brew install librsvg)
|
||||
import subprocess
|
||||
|
||||
try:
|
||||
subprocess.run(
|
||||
["rsvg-convert", "-w", "600", "-o", str(png_path), str(svg_path)],
|
||||
check=True,
|
||||
capture_output=True,
|
||||
)
|
||||
print(f" Converted {svg_path.name} to PNG via rsvg-convert")
|
||||
return png_path
|
||||
except (FileNotFoundError, subprocess.CalledProcessError):
|
||||
print(" rsvg-convert not available either")
|
||||
|
||||
# Last resort: create text-based logo
|
||||
print(" WARNING: No SVG converter found. Creating text-based logo fallback.")
|
||||
print(" Install cairosvg (pip install cairosvg) or librsvg (brew install librsvg) for proper logo.")
|
||||
img = Image.new("RGBA", (600, 150), (0, 0, 0, 0))
|
||||
draw = ImageDraw.Draw(img)
|
||||
try:
|
||||
font = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 80)
|
||||
except OSError:
|
||||
font = ImageFont.load_default()
|
||||
draw.text((50, 30), "singa", fill=WHITE_RGB, font=font)
|
||||
img.save(png_path)
|
||||
return png_path
|
||||
|
||||
|
||||
def download_inter_font(output_dir: Path) -> Path:
|
||||
"""Download Inter SemiBold TTF font."""
|
||||
font_path = output_dir / "Inter-SemiBold.ttf"
|
||||
|
||||
# Try downloading the static Inter SemiBold directly from GitHub
|
||||
static_url = (
|
||||
"https://github.com/rsms/inter/releases/download/v4.1/Inter-4.1.zip"
|
||||
)
|
||||
print(" Downloading Inter font package...")
|
||||
|
||||
try:
|
||||
response = requests.get(static_url, timeout=60, stream=True)
|
||||
response.raise_for_status()
|
||||
|
||||
import zipfile
|
||||
|
||||
zip_data = io.BytesIO(response.content)
|
||||
with zipfile.ZipFile(zip_data) as zf:
|
||||
# Look for Inter-SemiBold.ttf in the zip
|
||||
for name in zf.namelist():
|
||||
if name.endswith("Inter-SemiBold.ttf"):
|
||||
with zf.open(name) as src, open(font_path, "wb") as dst:
|
||||
dst.write(src.read())
|
||||
print(f" Extracted {name}")
|
||||
return font_path
|
||||
|
||||
# If no static SemiBold, look for any static TTF
|
||||
for name in sorted(zf.namelist()):
|
||||
if "static" in name.lower() and name.endswith(".ttf"):
|
||||
print(f" Available: {name}")
|
||||
|
||||
# Fallback: use the variable font
|
||||
for name in zf.namelist():
|
||||
if name.endswith("Inter.ttc") or (
|
||||
"Inter" in name and name.endswith(".ttf") and "static" not in name.lower()
|
||||
):
|
||||
with zf.open(name) as src, open(font_path, "wb") as dst:
|
||||
dst.write(src.read())
|
||||
print(f" Extracted variable font: {name}")
|
||||
return font_path
|
||||
|
||||
print(" WARNING: Could not find Inter SemiBold in zip")
|
||||
except Exception as e:
|
||||
print(f" WARNING: Failed to download Inter font: {e}")
|
||||
|
||||
# Final fallback: try Google Fonts API
|
||||
try:
|
||||
gf_url = "https://fonts.google.com/download?family=Inter"
|
||||
print(" Trying Google Fonts download...")
|
||||
response = requests.get(gf_url, timeout=60)
|
||||
response.raise_for_status()
|
||||
|
||||
import zipfile
|
||||
|
||||
zip_data = io.BytesIO(response.content)
|
||||
with zipfile.ZipFile(zip_data) as zf:
|
||||
for name in zf.namelist():
|
||||
if "SemiBold" in name and name.endswith(".ttf"):
|
||||
with zf.open(name) as src, open(font_path, "wb") as dst:
|
||||
dst.write(src.read())
|
||||
print(f" Extracted {name}")
|
||||
return font_path
|
||||
except Exception as e:
|
||||
print(f" WARNING: Google Fonts fallback also failed: {e}")
|
||||
|
||||
raise RuntimeError(
|
||||
"Could not download Inter font. Please manually place Inter-SemiBold.ttf "
|
||||
f"at {font_path}"
|
||||
)
|
||||
|
||||
|
||||
def generate_4k_intro_background(output_dir: Path, logo_path: Path) -> Path:
|
||||
"""Generate 4K intro background: black with subtle gradient, logo, green accent line."""
|
||||
path = output_dir / "intro_background.png"
|
||||
img = Image.new("RGB", (VIDEO_4K_WIDTH, VIDEO_4K_HEIGHT), BLACK_RGB)
|
||||
draw = ImageDraw.Draw(img)
|
||||
|
||||
# Subtle radial gradient from center (slightly lighter) to edges (pure black)
|
||||
_draw_radial_gradient(
|
||||
img,
|
||||
center=(VIDEO_4K_WIDTH // 2, VIDEO_4K_HEIGHT // 3),
|
||||
radius=VIDEO_4K_HEIGHT,
|
||||
center_color=(20, 20, 20),
|
||||
edge_color=BLACK_RGB,
|
||||
)
|
||||
|
||||
# Load and place logo in upper-center area
|
||||
try:
|
||||
logo = Image.open(logo_path).convert("RGBA")
|
||||
# Scale logo to ~800px wide, maintaining aspect ratio
|
||||
logo_target_width = 800
|
||||
scale = logo_target_width / logo.width
|
||||
logo_resized = logo.resize(
|
||||
(int(logo.width * scale), int(logo.height * scale)),
|
||||
Image.LANCZOS,
|
||||
)
|
||||
logo_x = (VIDEO_4K_WIDTH - logo_resized.width) // 2
|
||||
logo_y = VIDEO_4K_HEIGHT // 3 - logo_resized.height // 2
|
||||
img.paste(logo_resized, (logo_x, logo_y), logo_resized)
|
||||
except Exception as e:
|
||||
print(f" WARNING: Could not place logo on intro background: {e}")
|
||||
|
||||
# Thin green accent line below logo
|
||||
line_y = VIDEO_4K_HEIGHT // 3 + 200
|
||||
line_width = 600
|
||||
line_x_start = (VIDEO_4K_WIDTH - line_width) // 2
|
||||
draw.line(
|
||||
[(line_x_start, line_y), (line_x_start + line_width, line_y)],
|
||||
fill=GREEN_RGB,
|
||||
width=3,
|
||||
)
|
||||
|
||||
img.save(path, "PNG")
|
||||
print(f" Generated: intro_background.png ({VIDEO_4K_WIDTH}x{VIDEO_4K_HEIGHT})")
|
||||
return path
|
||||
|
||||
|
||||
def generate_4k_karaoke_background(output_dir: Path) -> Path:
|
||||
"""Generate 4K karaoke background: near-black with very subtle radial gradient."""
|
||||
path = output_dir / "karaoke_background.png"
|
||||
img = Image.new("RGB", (VIDEO_4K_WIDTH, VIDEO_4K_HEIGHT), BLACK_RGB)
|
||||
|
||||
# Very subtle radial gradient - dark center to slightly lighter edges
|
||||
# This needs to be extremely subtle so lyrics remain clearly readable
|
||||
_draw_radial_gradient(
|
||||
img,
|
||||
center=(VIDEO_4K_WIDTH // 2, VIDEO_4K_HEIGHT // 2),
|
||||
radius=max(VIDEO_4K_WIDTH, VIDEO_4K_HEIGHT),
|
||||
center_color=BLACK_RGB,
|
||||
edge_color=(12, 12, 12),
|
||||
)
|
||||
|
||||
img.save(path, "PNG")
|
||||
print(f" Generated: karaoke_background.png ({VIDEO_4K_WIDTH}x{VIDEO_4K_HEIGHT})")
|
||||
return path
|
||||
|
||||
|
||||
def generate_4k_end_background(output_dir: Path, logo_path: Path) -> Path:
|
||||
"""Generate 4K end background: same style as intro."""
|
||||
path = output_dir / "end_background.png"
|
||||
img = Image.new("RGB", (VIDEO_4K_WIDTH, VIDEO_4K_HEIGHT), BLACK_RGB)
|
||||
draw = ImageDraw.Draw(img)
|
||||
|
||||
# Subtle radial gradient
|
||||
_draw_radial_gradient(
|
||||
img,
|
||||
center=(VIDEO_4K_WIDTH // 2, VIDEO_4K_HEIGHT // 3),
|
||||
radius=VIDEO_4K_HEIGHT,
|
||||
center_color=(20, 20, 20),
|
||||
edge_color=BLACK_RGB,
|
||||
)
|
||||
|
||||
# Load and place logo
|
||||
try:
|
||||
logo = Image.open(logo_path).convert("RGBA")
|
||||
logo_target_width = 800
|
||||
scale = logo_target_width / logo.width
|
||||
logo_resized = logo.resize(
|
||||
(int(logo.width * scale), int(logo.height * scale)),
|
||||
Image.LANCZOS,
|
||||
)
|
||||
logo_x = (VIDEO_4K_WIDTH - logo_resized.width) // 2
|
||||
logo_y = VIDEO_4K_HEIGHT // 3 - logo_resized.height // 2
|
||||
img.paste(logo_resized, (logo_x, logo_y), logo_resized)
|
||||
except Exception as e:
|
||||
print(f" WARNING: Could not place logo on end background: {e}")
|
||||
|
||||
# Thin green accent line below logo
|
||||
line_y = VIDEO_4K_HEIGHT // 3 + 200
|
||||
line_width = 600
|
||||
line_x_start = (VIDEO_4K_WIDTH - line_width) // 2
|
||||
draw.line(
|
||||
[(line_x_start, line_y), (line_x_start + line_width, line_y)],
|
||||
fill=GREEN_RGB,
|
||||
width=3,
|
||||
)
|
||||
|
||||
img.save(path, "PNG")
|
||||
print(f" Generated: end_background.png ({VIDEO_4K_WIDTH}x{VIDEO_4K_HEIGHT})")
|
||||
return path
|
||||
|
||||
|
||||
def generate_cdg_title_background(output_dir: Path) -> Path:
|
||||
"""Generate CDG title/outro background: black with green border accent, 4-color indexed GIF."""
|
||||
path = output_dir / "cdg_title_background.gif"
|
||||
|
||||
# Create in RGB first, then convert to palette
|
||||
img = Image.new("RGB", (CDG_WIDTH, CDG_HEIGHT), BLACK_RGB)
|
||||
draw = ImageDraw.Draw(img)
|
||||
|
||||
# Green border accent (thin lines on edges)
|
||||
border_width = 2
|
||||
# Top border
|
||||
draw.rectangle(
|
||||
[0, 0, CDG_WIDTH - 1, border_width - 1],
|
||||
fill=GREEN_RGB,
|
||||
)
|
||||
# Bottom border
|
||||
draw.rectangle(
|
||||
[0, CDG_HEIGHT - border_width, CDG_WIDTH - 1, CDG_HEIGHT - 1],
|
||||
fill=GREEN_RGB,
|
||||
)
|
||||
# Left border
|
||||
draw.rectangle(
|
||||
[0, 0, border_width - 1, CDG_HEIGHT - 1],
|
||||
fill=GREEN_RGB,
|
||||
)
|
||||
# Right border
|
||||
draw.rectangle(
|
||||
[CDG_WIDTH - border_width, 0, CDG_WIDTH - 1, CDG_HEIGHT - 1],
|
||||
fill=GREEN_RGB,
|
||||
)
|
||||
|
||||
# Convert to indexed color (4-color palette for CDG compatibility)
|
||||
# CDG supports max 16 colors, but we keep it minimal
|
||||
palette_img = _convert_to_indexed_gif(img)
|
||||
palette_img.save(path, "GIF")
|
||||
print(f" Generated: cdg_title_background.gif ({CDG_WIDTH}x{CDG_HEIGHT})")
|
||||
return path
|
||||
|
||||
|
||||
def generate_cdg_instrumental_background(output_dir: Path) -> Path:
|
||||
"""Generate CDG instrumental background: black with green accents and text area."""
|
||||
path = output_dir / "cdg_instrumental_background.gif"
|
||||
|
||||
img = Image.new("RGB", (CDG_WIDTH, CDG_HEIGHT), BLACK_RGB)
|
||||
draw = ImageDraw.Draw(img)
|
||||
|
||||
# Green accent lines (horizontal, subtle)
|
||||
line_y_top = CDG_HEIGHT // 3
|
||||
line_y_bottom = 2 * CDG_HEIGHT // 3
|
||||
draw.line(
|
||||
[(20, line_y_top), (CDG_WIDTH - 20, line_y_top)],
|
||||
fill=GREEN_RGB,
|
||||
width=1,
|
||||
)
|
||||
draw.line(
|
||||
[(20, line_y_bottom), (CDG_WIDTH - 20, line_y_bottom)],
|
||||
fill=GREEN_RGB,
|
||||
width=1,
|
||||
)
|
||||
|
||||
# Convert to indexed GIF
|
||||
palette_img = _convert_to_indexed_gif(img)
|
||||
palette_img.save(path, "GIF")
|
||||
print(f" Generated: cdg_instrumental_background.gif ({CDG_WIDTH}x{CDG_HEIGHT})")
|
||||
return path
|
||||
|
||||
|
||||
def _draw_radial_gradient(
|
||||
img: Image.Image,
|
||||
center: tuple[int, int],
|
||||
radius: int,
|
||||
center_color: tuple[int, int, int],
|
||||
edge_color: tuple[int, int, int],
|
||||
) -> None:
|
||||
"""Draw a radial gradient on an image. Generates at 1/4 resolution and upscales for speed."""
|
||||
width, height = img.size
|
||||
|
||||
# Generate at 1/4 resolution for speed, then upscale (gradient is smooth)
|
||||
scale = 4
|
||||
small_w, small_h = width // scale, height // scale
|
||||
cx, cy = center[0] // scale, center[1] // scale
|
||||
small_radius = radius // scale
|
||||
|
||||
try:
|
||||
import numpy as np
|
||||
|
||||
y_coords, x_coords = np.mgrid[0:small_h, 0:small_w]
|
||||
dist = np.sqrt((x_coords - cx) ** 2 + (y_coords - cy) ** 2)
|
||||
t = np.clip(dist / small_radius, 0, 1)
|
||||
|
||||
result = np.zeros((small_h, small_w, 3), dtype=np.uint8)
|
||||
for c in range(3):
|
||||
result[:, :, c] = (
|
||||
center_color[c] + (edge_color[c] - center_color[c]) * t
|
||||
).astype(np.uint8)
|
||||
|
||||
small_img = Image.fromarray(result)
|
||||
except ImportError:
|
||||
# Pure Pillow fallback at reduced resolution
|
||||
small_img = Image.new("RGB", (small_w, small_h), edge_color)
|
||||
pixels = small_img.load()
|
||||
for y in range(small_h):
|
||||
for x in range(small_w):
|
||||
dist = math.sqrt((x - cx) ** 2 + (y - cy) ** 2)
|
||||
t = min(dist / small_radius, 1.0)
|
||||
r = int(center_color[0] + (edge_color[0] - center_color[0]) * t)
|
||||
g = int(center_color[1] + (edge_color[1] - center_color[1]) * t)
|
||||
b = int(center_color[2] + (edge_color[2] - center_color[2]) * t)
|
||||
pixels[x, y] = (r, g, b)
|
||||
|
||||
# Upscale to target resolution with smooth interpolation
|
||||
upscaled = small_img.resize((width, height), Image.LANCZOS)
|
||||
img.paste(upscaled, (0, 0))
|
||||
|
||||
|
||||
def _convert_to_indexed_gif(img: Image.Image) -> Image.Image:
|
||||
"""Convert RGB image to indexed color GIF with limited palette."""
|
||||
# Quantize to 4 colors for CDG compatibility
|
||||
return img.quantize(colors=4, method=Image.Quantize.MEDIANCUT)
|
||||
|
||||
|
||||
# ─── Configuration Builders ───────────────────────────────────────────────────
|
||||
|
||||
|
||||
def create_theme_config() -> dict:
|
||||
"""Create the Singa theme configuration (style_params.json)."""
|
||||
return {
|
||||
"intro": {
|
||||
"video_duration": 5,
|
||||
"existing_image": None,
|
||||
"background_color": SINGA_BLACK,
|
||||
"background_image": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/intro_background.png",
|
||||
"font": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/Inter-SemiBold.ttf",
|
||||
"title_region": "370,450,3100,480",
|
||||
"title_text_transform": None,
|
||||
"title_color": SINGA_WHITE,
|
||||
"title_gradient": {
|
||||
"color1": SINGA_WHITE,
|
||||
"color2": SINGA_GREEN,
|
||||
"direction": "vertical",
|
||||
"start": 0.4,
|
||||
"stop": 0.8,
|
||||
},
|
||||
"artist_region": "370,1200,3100,480",
|
||||
"artist_text_transform": None,
|
||||
"artist_color": SINGA_GREEN,
|
||||
"artist_gradient": None,
|
||||
"extra_text": None,
|
||||
"extra_text_color": SINGA_WHITE,
|
||||
"extra_text_region": None,
|
||||
"extra_text_gradient": None,
|
||||
},
|
||||
"karaoke": {
|
||||
"background_color": SINGA_BLACK,
|
||||
"background_image": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/karaoke_background.png",
|
||||
"font": "Inter SemiBold",
|
||||
"font_path": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/Inter-SemiBold.ttf",
|
||||
"font_size": 420,
|
||||
"top_padding": 100,
|
||||
"ass_name": "Singa",
|
||||
"primary_color": "23, 232, 122, 255", # Green (sung)
|
||||
"secondary_color": "255, 255, 255, 255", # White (unsung)
|
||||
"outline_color": "0, 80, 50, 255", # Dark green
|
||||
"back_color": "0, 0, 0, 255",
|
||||
"bold": False,
|
||||
"italic": False,
|
||||
"underline": False,
|
||||
"strike_out": False,
|
||||
"scale_x": 100,
|
||||
"scale_y": 100,
|
||||
"spacing": 0,
|
||||
"angle": 0.0,
|
||||
"border_style": 1,
|
||||
"outline": 1,
|
||||
"shadow": 0,
|
||||
"margin_l": 0,
|
||||
"margin_r": 0,
|
||||
"margin_v": 0,
|
||||
"encoding": 0,
|
||||
},
|
||||
"end": {
|
||||
"video_duration": 5,
|
||||
"existing_image": None,
|
||||
"background_color": SINGA_BLACK,
|
||||
"background_image": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/end_background.png",
|
||||
"font": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/Inter-SemiBold.ttf",
|
||||
"title_region": None,
|
||||
"title_text_transform": "none",
|
||||
"title_color": SINGA_WHITE,
|
||||
"title_gradient": None,
|
||||
"artist_region": None,
|
||||
"artist_text_transform": "none",
|
||||
"artist_color": SINGA_GREEN,
|
||||
"artist_gradient": None,
|
||||
"extra_text": None,
|
||||
"extra_text_color": None,
|
||||
"extra_text_region": None,
|
||||
"extra_text_gradient": None,
|
||||
},
|
||||
"cdg": {
|
||||
"clear_mode": "eager",
|
||||
"sync_offset": 0,
|
||||
"lead_in_threshold": 300,
|
||||
"lead_in_duration": 30,
|
||||
"lead_in_total": 200,
|
||||
"lead_in_symbols": ["/>", ">", ">"],
|
||||
"row": 4,
|
||||
"line_tile_height": 3,
|
||||
"lines_per_page": 4,
|
||||
"background_color": SINGA_BLACK,
|
||||
"border_color": SINGA_GREEN,
|
||||
"title_color": SINGA_GREEN,
|
||||
"artist_color": SINGA_GREEN,
|
||||
"outro_line1_color": SINGA_GREEN,
|
||||
"outro_line2_color": SINGA_GREEN,
|
||||
"active_fill": SINGA_GREEN,
|
||||
"active_stroke": SINGA_BLACK,
|
||||
"inactive_fill": SINGA_WHITE,
|
||||
"inactive_stroke": SINGA_BLACK,
|
||||
"instrumental_font_color": SINGA_GREEN,
|
||||
"font_path": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/Inter-SemiBold.ttf",
|
||||
"font_size": 18,
|
||||
"stroke_width": 0,
|
||||
"stroke_style": "octagon",
|
||||
"instrumental_gap_threshold": 1500,
|
||||
"instrumental_text": "INSTRUMENTAL",
|
||||
"instrumental_background": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/cdg_instrumental_background.gif",
|
||||
"instrumental_transition": "topleftmusicalnotes",
|
||||
"title_screen_background": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/cdg_title_background.gif",
|
||||
"title_screen_transition": "centertexttoplogobottomtext",
|
||||
"title_artist_gap": 30,
|
||||
"intro_duration_seconds": 10.0,
|
||||
"first_syllable_buffer_seconds": 3.0,
|
||||
"outro_background": f"gs://{GCS_BUCKET}/themes/{THEME_ID}/assets/cdg_title_background.gif",
|
||||
"outro_transition": "centertexttoplogobottomtext",
|
||||
"outro_text_line1": "$title",
|
||||
"outro_text_line2": "$artist",
|
||||
"outro_line1_line2_gap": 30,
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def create_tenant_config() -> dict:
|
||||
"""Create the Singa tenant configuration."""
|
||||
return {
|
||||
"id": TENANT_ID,
|
||||
"name": "Singa",
|
||||
"subdomain": "singa.nomadkaraoke.com",
|
||||
"is_active": True,
|
||||
"branding": {
|
||||
"logo_url": f"https://api.nomadkaraoke.com/api/tenant/asset/{TENANT_ID}/logo.png",
|
||||
"logo_height": 50,
|
||||
"primary_color": SINGA_GREEN,
|
||||
"secondary_color": SINGA_WHITE,
|
||||
"accent_color": SINGA_GREEN,
|
||||
"background_color": SINGA_BLACK,
|
||||
"favicon_url": None,
|
||||
"site_title": "Singa Karaoke Generator",
|
||||
"tagline": "Sing your favorite karaoke songs",
|
||||
},
|
||||
"features": {
|
||||
"audio_search": False,
|
||||
"file_upload": True,
|
||||
"youtube_url": False,
|
||||
"youtube_upload": False,
|
||||
"dropbox_upload": False,
|
||||
"gdrive_upload": False,
|
||||
"theme_selection": False,
|
||||
"color_overrides": False,
|
||||
"enable_cdg": True,
|
||||
"enable_4k": True,
|
||||
"admin_access": False,
|
||||
},
|
||||
"defaults": {
|
||||
"theme_id": THEME_ID,
|
||||
"locked_theme": THEME_ID,
|
||||
"distribution_mode": "download_only",
|
||||
"brand_prefix": "SINGA",
|
||||
"youtube_description_template": None,
|
||||
},
|
||||
"auth": {
|
||||
"allowed_email_domains": ["singa.com", "nomadkaraoke.com"],
|
||||
"require_email_domain": True,
|
||||
"fixed_token_ids": [],
|
||||
"sender_email": "singa@nomadkaraoke.com",
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def create_theme_metadata() -> dict:
|
||||
"""Create the theme metadata entry for the registry."""
|
||||
return {
|
||||
"id": THEME_ID,
|
||||
"name": "Singa",
|
||||
"description": "Official Singa karaoke style with green/white color scheme on black",
|
||||
"is_default": False,
|
||||
}
|
||||
|
||||
|
||||
# ─── GCS Upload Helpers ───────────────────────────────────────────────────────
|
||||
|
||||
|
||||
def upload_file(bucket, source_path: Path, dest_path: str) -> str:
|
||||
"""Upload a file to GCS and return the gs:// URL."""
|
||||
blob = bucket.blob(dest_path)
|
||||
blob.upload_from_filename(str(source_path))
|
||||
gs_url = f"gs://{GCS_BUCKET}/{dest_path}"
|
||||
print(f" Uploaded: {source_path.name} -> {gs_url}")
|
||||
return gs_url
|
||||
|
||||
|
||||
def upload_json(bucket, data: dict, dest_path: str) -> str:
|
||||
"""Upload a JSON object to GCS and return the gs:// URL."""
|
||||
blob = bucket.blob(dest_path)
|
||||
blob.upload_from_string(
|
||||
json.dumps(data, indent=2),
|
||||
content_type="application/json",
|
||||
)
|
||||
gs_url = f"gs://{GCS_BUCKET}/{dest_path}"
|
||||
print(f" Created: {gs_url}")
|
||||
return gs_url
|
||||
|
||||
|
||||
# ─── Main ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
|
||||
def main():
|
||||
import argparse
|
||||
|
||||
parser = argparse.ArgumentParser(description="Setup Singa tenant on Nomad Karaoke")
|
||||
parser.add_argument(
|
||||
"--logo",
|
||||
type=Path,
|
||||
default=SINGA_LOGO_SVG_DEFAULT,
|
||||
help=f"Path to Singa logo SVG (default: {SINGA_LOGO_SVG_DEFAULT})",
|
||||
)
|
||||
args = parser.parse_args()
|
||||
|
||||
print("=" * 60)
|
||||
print("Singa Tenant Setup")
|
||||
print("=" * 60)
|
||||
print()
|
||||
print("This script generates all Singa assets programmatically")
|
||||
print("and uploads them to GCS.")
|
||||
print()
|
||||
|
||||
with tempfile.TemporaryDirectory(prefix="singa-tenant-") as tmp_dir:
|
||||
tmp_path = Path(tmp_dir)
|
||||
|
||||
# Step 1: Convert logo SVG to PNG
|
||||
print("1. Converting Singa logo SVG to PNG...")
|
||||
logo_path = convert_logo(tmp_path, args.logo)
|
||||
print()
|
||||
|
||||
# Step 2: Download Inter font
|
||||
print("2. Downloading Inter SemiBold font...")
|
||||
font_path = download_inter_font(tmp_path)
|
||||
print()
|
||||
|
||||
# Step 3: Generate 4K backgrounds
|
||||
print("3. Generating 4K backgrounds (3840x2160)...")
|
||||
intro_bg = generate_4k_intro_background(tmp_path, logo_path)
|
||||
karaoke_bg = generate_4k_karaoke_background(tmp_path)
|
||||
end_bg = generate_4k_end_background(tmp_path, logo_path)
|
||||
print()
|
||||
|
||||
# Step 4: Generate CDG backgrounds
|
||||
print("4. Generating CDG backgrounds (300x216)...")
|
||||
cdg_title_bg = generate_cdg_title_background(tmp_path)
|
||||
cdg_instrumental_bg = generate_cdg_instrumental_background(tmp_path)
|
||||
print()
|
||||
|
||||
# Step 5: Connect to GCS
|
||||
print("5. Connecting to GCS...")
|
||||
try:
|
||||
client = storage.Client()
|
||||
bucket = client.bucket(GCS_BUCKET)
|
||||
print(f" Connected to bucket: {GCS_BUCKET}")
|
||||
except Exception as e:
|
||||
print(f" ERROR: Failed to connect to GCS: {e}")
|
||||
print(" Make sure you've run: gcloud auth application-default login")
|
||||
sys.exit(1)
|
||||
print()
|
||||
|
||||
# Step 6: Upload theme assets
|
||||
print(f"6. Uploading theme assets to themes/{THEME_ID}/assets/...")
|
||||
assets = {
|
||||
intro_bg: "intro_background.png",
|
||||
karaoke_bg: "karaoke_background.png",
|
||||
end_bg: "end_background.png",
|
||||
font_path: "Inter-SemiBold.ttf",
|
||||
cdg_title_bg: "cdg_title_background.gif",
|
||||
cdg_instrumental_bg: "cdg_instrumental_background.gif",
|
||||
}
|
||||
for source, dest_name in assets.items():
|
||||
upload_file(bucket, source, f"themes/{THEME_ID}/assets/{dest_name}")
|
||||
print()
|
||||
|
||||
# Step 7: Upload theme config
|
||||
print(f"7. Uploading theme configuration...")
|
||||
theme_config = create_theme_config()
|
||||
upload_json(bucket, theme_config, f"themes/{THEME_ID}/style_params.json")
|
||||
print()
|
||||
|
||||
# Step 8: Upload tenant logo
|
||||
print(f"8. Uploading tenant logo...")
|
||||
upload_file(bucket, logo_path, f"tenants/{TENANT_ID}/logo.png")
|
||||
print()
|
||||
|
||||
# Step 9: Upload tenant config
|
||||
print(f"9. Uploading tenant configuration...")
|
||||
tenant_config = create_tenant_config()
|
||||
upload_json(bucket, tenant_config, f"tenants/{TENANT_ID}/config.json")
|
||||
print()
|
||||
|
||||
# Step 10: Update theme registry
|
||||
print(f"10. Updating theme registry...")
|
||||
registry_blob = bucket.blob("themes/_metadata.json")
|
||||
try:
|
||||
registry_data = json.loads(registry_blob.download_as_string())
|
||||
except Exception:
|
||||
print(" Creating new registry...")
|
||||
registry_data = {"version": 1, "themes": []}
|
||||
|
||||
existing_ids = [t["id"] for t in registry_data.get("themes", [])]
|
||||
if THEME_ID not in existing_ids:
|
||||
registry_data["themes"].append(create_theme_metadata())
|
||||
registry_blob.upload_from_string(
|
||||
json.dumps(registry_data, indent=2),
|
||||
content_type="application/json",
|
||||
)
|
||||
print(f" Added '{THEME_ID}' to theme registry")
|
||||
else:
|
||||
print(f" Theme '{THEME_ID}' already in registry, skipping")
|
||||
print()
|
||||
|
||||
# Step 11: Print summary and next steps
|
||||
print("=" * 60)
|
||||
print("Setup complete!")
|
||||
print("=" * 60)
|
||||
print()
|
||||
print(f" Tenant ID: {TENANT_ID}")
|
||||
print(f" Theme ID: {THEME_ID}")
|
||||
print(f" Subdomain: singa.nomadkaraoke.com")
|
||||
print()
|
||||
print("GCS paths created:")
|
||||
print(f" themes/{THEME_ID}/style_params.json")
|
||||
print(f" themes/{THEME_ID}/assets/ (6 files)")
|
||||
print(f" tenants/{TENANT_ID}/config.json")
|
||||
print(f" tenants/{TENANT_ID}/logo.png")
|
||||
print()
|
||||
print("─" * 60)
|
||||
print("MANUAL STEPS REQUIRED:")
|
||||
print("─" * 60)
|
||||
print()
|
||||
print("1. DNS: Add CNAME record")
|
||||
print(" singa.nomadkaraoke.com -> <cloudflare-pages-domain>")
|
||||
print()
|
||||
print("2. Cloudflare Pages: Add custom domain")
|
||||
print(" - Go to Cloudflare Pages > your project > Custom domains")
|
||||
print(" - Add 'singa.nomadkaraoke.com'")
|
||||
print()
|
||||
print("3. SendGrid: Verify sender (if needed)")
|
||||
print(" - Verify singa@nomadkaraoke.com as a sender identity")
|
||||
print(" - (May already be covered by domain-level verification)")
|
||||
print()
|
||||
print("4. Test:")
|
||||
print(" - API: curl -H 'X-Tenant-ID: singa' https://api.nomadkaraoke.com/api/tenant/config")
|
||||
print(" - GCS: gsutil ls gs://karaoke-gen-storage-nomadkaraoke/themes/singa/")
|
||||
print(" - GCS: gsutil ls gs://karaoke-gen-storage-nomadkaraoke/tenants/singa/")
|
||||
print(" - Web: https://singa.nomadkaraoke.com (after DNS propagation)")
|
||||
print()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
+2
-10
@@ -1,10 +1,2 @@
|
||||
{
|
||||
"build": {
|
||||
"command": "cd frontend-react && npm install && npm run build",
|
||||
"output": "frontend-react/dist"
|
||||
},
|
||||
"env": {
|
||||
"NODE_VERSION": "18"
|
||||
}
|
||||
}
|
||||
|
||||
name = "karaoke-gen"
|
||||
pages_build_output_dir = "frontend/out"
|
||||
Reference in new issue
Block a user