omplexity,
lines: file.lines,
});
});
// District hallways (connect district centers)
if (dirIdx > 0) {
const prev = layout.districts[dirIdx - 1];
layout.hallways.push({
from: { x: prev.position.x, z: prev.position.z },
to: { x: districtX, z: districtZ },
});
}
});
return layout;
}
return { load, get, hasFullMap, toLayout };
})();
===== FILE: public/solidability-world/js/sw-onboard.js =====
// Solidability Universal Core — Onboarding Flow
// Guides new users: connect → authorize → analyze → generate → tour.
// Each user's world is isolated. Read-only by default.
const SWOnboard = (() => {
let currentStep = 'welcome';
const steps = [
{ id: 'welcome', title: 'Welcome to Solidability', desc: 'Your Website. Your AI. Your Authority.' },
{ id: 'connect', title: 'Connect Your Code', desc: 'Link your website or repository for read-only analysis.' },
{ id: 'authorize', title: 'Authorize Access', desc: 'Grant read-only permission. You control what we see.' },
{ id: 'analyze', title: 'Analyzing Architecture', desc: 'Mapping files, functions, routes, and dependencies.' },
{ id: 'generate', title: 'Building Your World', desc: 'Calculating geometry from structural complexity.' },
{ id: 'tour', title: 'Meet Your Software', desc: 'AI Drive will walk you through your world.' },
];
function showOnboarding() {
let panel = document.getElementById('sw-onboard');
if (!panel) {
panel = document.createElement('div');
panel.id = 'sw-onboard';
document.getElementById('app').appendChild(panel);
}
renderStep(panel);
panel.classList.add('visible');
}
function renderStep(panel) {
const step = steps.find(s => s.id === currentStep);
const idx = steps.indexOf(step);
let content = '';
switch (currentStep) {
case 'welcome':
content = `
Solidability turns your codebase into an explorable 3D world.
Walk through your architecture. Inspect real source code. Let AI Drive guide you.
`;
break;
case 'connect':
content = `
How is your code hosted?
`;
break;
case 'authorize':
content = `
🔒 Read-Only Access
- ✓ Read source files and directory structure
- ✓ Extract functions, routes, dependencies
- ✗ Never modify your code
- ✗ Never access secrets, keys, or credentials
- ✗ Never deploy or execute changes
Your world is isolated. No other user can see it.
`;
break;
case 'analyze':
content = `
Scanning your codebase...
`;
// Trigger analysis
setTimeout(runAnalysis, 500);
break;
case 'generate':
content = `
Calculating world geometry...
`;
setTimeout(runGeneration, 500);
break;
case 'tour':
content = `
Your world is ready.
AI Drive will now walk you through your software.