Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

4.0 KB
Raw Blame
// dashboard-next — shell bootstrap.
//
// Every page in /dashboard-next imports this module. It renders the
// sidebar / topbar / drawer slot / palette overlay into <body>, then
// hands control back so the page module can render its own content
// into the <main> slot.
//
// Usage from a page entry module:
//
//   import { mountShell } from '/src/dashboard-next/shell.js';
//   const main = await mountShell();
//   main.innerHTML = '<h1>Hello</h1>';

import { renderSidebar,  mountSidebarBehavior, mountMobileNavBehavior } from './components/sidebar.js';
import { renderTopbar,   mountTopbarBehavior  } from './components/topbar.js';
import { renderDrawer,   mountDrawerBehavior  } from './components/drawer.js';
import { mountPaletteBehavior } from './components/palette.js';
import { claimPendingReferral } from './referral-claim.js';
import { track, ANALYTICS_EVENTS } from '../analytics.js';
import { getMe } from './api.js';

/**
 * Build the shell, mount its behaviour, and resolve to the <main> slot
 * the caller should write its page content into.
 *
 * @returns {Promise<HTMLElement>}  the inner content container
 */
export async function mountShell() {
	if (document.querySelector('.dn-shell')) {
		// Some other page module already mounted us — return the slot.
		const existing = document.querySelector('.dn-main-inner');
		if (existing) return existing;
	}

	document.body.classList.add('dn-body');

	// Resolved before the rail renders. Cached by getMe(), so any page
	// module's later requireUser() call reuses this same request.
	await getMe();

	// Skip-link — hidden until focused, then jumps to main content. Lives
	// outside the shell grid so it can absolutely-position over chrome.
	if (!document.querySelector('.dn-skip')) {
		const skip = document.createElement('a');
		skip.className = 'dn-skip';
		skip.href = '#dn-main';
		skip.textContent = 'Skip to content';
		document.body.insertBefore(skip, document.body.firstChild);
	}

	const shell = document.createElement('div');
	shell.className = 'dn-shell';
	shell.setAttribute('data-rail-collapsed', 'false');
	shell.setAttribute('data-drawer-open', 'false');
	shell.innerHTML = `
		${renderSidebar(location.pathname)}
		${renderTopbar(location.pathname)}
		<main class="dn-main" id="dn-main" tabindex="-1">
			<div class="dn-main-inner" data-slot="page"></div>
		</main>
		${renderDrawer()}
	`;
	document.body.appendChild(shell);

	// Engagement: a dashboard surface opened. The first path segment after
	// /dashboard names the surface (e.g. 'monetize', 'holders'), else 'home'.
	track(ANALYTICS_EVENTS.SURFACE_OPENED, {
		surface: `dashboard:${location.pathname.replace(/^\/dashboard\/?/, '').split('/')[0] || 'home'}`,
	});

	mountSidebarBehavior(shell);
	mountMobileNavBehavior(shell, location.pathname);
	mountTopbarBehavior(shell);
	mountDrawerBehavior(shell);
	mountPaletteBehavior();
	mountDrawerPulse(shell);

	// If the user arrived via a referral link, attribute it now that they have a
	// session. No-ops without a pending code; never blocks the page.
	claimPendingReferral().catch(() => {});

	// Light-up touch — the sidebar item we land on gets a brief accent
	// pulse so users see "you are here" without having to track the
	// indicator bar. Tasteful, not festive.
	const here = shell.querySelector('.dn-rail-item[aria-current="page"]');
	if (here) {
		here.animate(
			[{ background: 'rgba(200,202,208,0.28)' }, { background: 'rgba(200,202,208,0.14)' }],
			{ duration: 600, easing: 'ease-out' },
		);
	}

	return shell.querySelector('[data-slot="page"]');
}

// Listen for new-event signals dispatched by the drawer's live feed and
// briefly pulse the drawer toggle so the user knows there's something
// fresh to look at without having to open the drawer first.
function mountDrawerPulse(shellEl) {
	window.addEventListener('dn:drawer:new-event', () => {
		const btn = shellEl.querySelector('[data-action="toggle-drawer"]');
		if (!btn) return;
		btn.setAttribute('data-pulse', 'true');
		setTimeout(() => btn.removeAttribute('data-pulse'), 2500);
	});
}