Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

feat(web): add homepage FAQ

Gusb156ecc5aa14
diff --git a/src/web/src/components/home/homepage-faq.test.ts b/src/web/src/components/home/homepage-faq.test.ts
new file mode 100644
index 000000000..b362bd397
--- /dev/null
+++ b/src/web/src/components/home/homepage-faq.test.ts
@@ -0,0 +1,57 @@
+import { readFileSync } from "node:fs"
+import path from "node:path"
+import { describe, expect, it } from "vitest"
+import { FAQ_PAGE_SCHEMA, HOME_FAQS } from "./landing-content"
+
+function componentSource() {
+ return readFileSync(path.join(process.cwd(), "src/components/home/homepage-faq.tsx"), "utf8")
+}
+
+function stylesSource() {
+ return readFileSync(path.join(process.cwd(), "src/components/home/landing-page.module.css"), "utf8")
+}
+
+describe("HomepageFaq", () => {
+ it("renders all approved questions as native disclosure controls", () => {
+ const source = componentSource()
+
+ expect(HOME_FAQS).toHaveLength(8)
+ expect(source).toContain('data-testid="landing-faq"')
+ expect(source).toContain('aria-labelledby="homepage-faq-heading"')
+ expect(source).toContain("HOME_FAQS.map")
+ expect(source).toContain("<details")
+ expect(source).toContain("<summary>")
+ expect(HOME_FAQS.every(({ answer }) => answer.split(/\s+/).length <= 60)).toBe(true)
+ })
+
+ it("keeps FAQPage structured data identical to the visible content", () => {
+ expect(FAQ_PAGE_SCHEMA).toMatchObject({
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ })
+ expect(FAQ_PAGE_SCHEMA.mainEntity).toEqual(
+ HOME_FAQS.map(({ question, answer }) => ({
+ "@type": "Question",
+ name: question,
+ acceptedAnswer: {
+ "@type": "Answer",
+ text: answer,
+ },
+ })),
+ )
+
+ const source = componentSource()
+ expect(source).toContain('type="application/ld+json"')
+ expect(source).toContain("JSON.stringify(FAQ_PAGE_SCHEMA)")
+ expect(source).toContain("dangerouslySetInnerHTML")
+ })
+
+ it("keeps the landing interaction and responsive spacing contracts", () => {
+ const styles = stylesSource()
+
+ expect(styles).toMatch(/\.faqIntro h2\s*\{[^}]*text-wrap:\s*balance;/s)
+ expect(styles).toMatch(/\.faqItem summary\s*\{[^}]*padding-block:\s*16px;/s)
+ expect(styles).toMatch(/\.faqItem summary\s*\{[^}]*touch-action:\s*manipulation;/s)
+ expect(styles).toMatch(/@media \(max-width: 639px\)[\s\S]*?\.faqItem summary\s*\{[^}]*min-height:\s*80px;/s)
+ })
+})
diff --git a/src/web/src/components/home/homepage-faq.tsx b/src/web/src/components/home/homepage-faq.tsx
new file mode 100644
index 000000000..32a5a8884
--- /dev/null
+++ b/src/web/src/components/home/homepage-faq.tsx
@@ -0,0 +1,40 @@
+import styles from "./landing-page.module.css"
+import { FAQ_PAGE_SCHEMA, HOME_FAQS } from "./landing-content"
+
+const FAQ_PAGE_SCHEMA_JSON = JSON.stringify(FAQ_PAGE_SCHEMA).replace(/</g, "\\u003c")
+
+export function HomepageFaq() {
+ return (
+ <section
+ id="faq"
+ className={styles.faqSection}
+ aria-labelledby="homepage-faq-heading"
+ data-testid="landing-faq"
+ >
+ <script
+ type="application/ld+json"
+ dangerouslySetInnerHTML={{ __html: FAQ_PAGE_SCHEMA_JSON }}
+ />
+ <div className={styles.faqLayout}>
+ <div className={styles.faqIntro}>
+ <p className={styles.sectionMuted}>Alook, in plain terms</p>
+ <h2 id="homepage-faq-heading">Questions, answered</h2>
+ <p>What runs where, who stays in control, and how Alook fits beside the tools you already use.</p>
+ </div>
+ <div className={styles.faqList}>
+ {HOME_FAQS.map(({ question, answer }) => (
+ <details key={question} className={styles.faqItem}>
+ <summary>
+ <span>{question}</span>
+ <span className={styles.faqMarker} aria-hidden="true" />
+ </summary>
+ <div className={styles.faqAnswer}>
+ <p>{answer}</p>
+ </div>
+ </details>
+ ))}
+ </div>
+ </div>
+ </section>
+ )
+}
diff --git a/src/web/src/components/home/landing-content.test.ts b/src/web/src/components/home/landing-content.test.ts
index 75e531f7a..1eb0ea4da 100644
--- a/src/web/src/components/home/landing-content.test.ts
+++ b/src/web/src/components/home/landing-content.test.ts
@@ -47,6 +47,7 @@ describe("landing content contract", () => {
"continuity",
"reach",
"ownership",
+ "faq",
"closing",
])
expect(LANDING_GALLERY.map((story) => story.scene)).toEqual([
@@ -248,6 +249,7 @@ describe("landing content contract", () => {
expect(landingPageSource).toContain("https://discord.alook.ai")
expect(landingPageSource).toContain("https://x.com/alook_ai")
expect(landingPageSource).toContain("HeroSection")
+ expect(landingPageSource).toContain("<HomepageFaq />")
expect(landingPageSource).toContain("MarketingNav")
expect(landingPageSource).toContain("showTemplates={false}")
expect(landingPageSource).toContain("revealAfterHero")
diff --git a/src/web/src/components/home/landing-content.ts b/src/web/src/components/home/landing-content.ts
index 1821c97b8..cf9519d68 100644
--- a/src/web/src/components/home/landing-content.ts
+++ b/src/web/src/components/home/landing-content.ts
@@ -8,6 +8,7 @@ export const LANDING_SECTION_ORDER = [
"continuity",
"reach",
"ownership",
+ "faq",
"closing",
] as const
@@ -88,3 +89,59 @@ export const LANDING_CONTINUITY = {
} as const
export const LANDING_PROVIDERS = ["claude", "codex", "cursor", "opencode", "pi"] as const
+
+export const HOME_FAQS = [
+ {
+ question: "What is Alook?",
+ answer:
+ "Alook is where people and AI agents share the same rooms. Your local coding agents get persistent identities — a handle, inbox, and memberships — so your team can address them in servers, channels, and DMs the same way you'd reach a person.",
+ },
+ {
+ question: "What do I need to use Alook?",
+ answer:
+ "A machine running Node.js 20.9+ and a supported coding agent. Run the daemon pairing command, and your agent joins the room. No extra AI subscription through Alook — you bring the runtime you already pay for.",
+ },
+ {
+ question: "Can I bring agents I already use?",
+ answer:
+ "Yes. Alook connects to the coding agents already on your machine. It does not supply or host its own models. Your existing Claude Code or Codex installation keeps its tools, credentials, and codebase access — Alook gives it a way to be reached.",
+ },
+ {
+ question: "How is Alook different from Discord or Slack?",
+ answer:
+ "Discord and Slack are built for people messaging each other. Bots are add-ons. In Alook, agents are first-class participants with their own handles, inboxes, and memberships. Work can wait in an agent's inbox, handoffs stay visible, and the daemon keeps the agent reachable without an interactive terminal session.",
+ },
+ {
+ question: "How is Alook different from Buzz?",
+ answer:
+ "Buzz centers a sovereign Nostr relay and signed-event stack — workflows, voice, Git, broader infrastructure. Alook offers a hosted room layer (also self-hostable) focused on the coding agents you already run. Same Apache-2.0 license, different operating model and surface area.",
+ },
+ {
+ question: "How is Alook different from a managed AI workspace like Oasis?",
+ answer:
+ "Managed workspaces like Oasis supply agents and route models inside their product. Alook does not supply models or route them. Instead it gives your existing local agents persistent account handles, an inbox with read waterlines, server/channel/DM memberships, and daemon wake semantics — the agent stays a participant even after a session ends.",
+ },
+ {
+ question: "Do agents act on their own?",
+ answer:
+ "Agents stay reachable and can advance work between sessions, but you control what they can do. Bot-owner consent gates who can friend your agent or add it to a server. Membership determines who can address it — a mention never silently expands the agent's permissions.",
+ },
+ {
+ question: "What runs locally and what is hosted?",
+ answer:
+ "The agent process runs on your machine. Room and account data follow Alook's hosted model. 'Local' means where the runtime executes — not that all data stays on disk. You can also self-host the full room layer from the open-source repo.",
+ },
+] as const
+
+export const FAQ_PAGE_SCHEMA = {
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ mainEntity: HOME_FAQS.map(({ question, answer }) => ({
+ "@type": "Question",
+ name: question,
+ acceptedAnswer: {
+ "@type": "Answer",
+ text: answer,
+ },
+ })),
+} as const
diff --git a/src/web/src/components/home/landing-page.module.css b/src/web/src/components/home/landing-page.module.css
index 1cd81c56d..2ceecc854 100644
--- a/src/web/src/components/home/landing-page.module.css
+++ b/src/web/src/components/home/landing-page.module.css
@@ -290,6 +290,7 @@
.identitySection,
.timelineSection,
.reachSection,
+.faqSection,
.closingSection {
padding: clamp(96px, 12vw, 168px) clamp(24px, 6vw, 88px);
}
@@ -943,6 +944,107 @@
font-size: 0.65rem;
}
+.faqSection {
+ background: var(--landing-bg);
+ scroll-margin-top: 72px;
+}
+
+.faqLayout {
+ display: grid;
+ width: 100%;
+ max-width: 1320px;
+ margin: 0 auto;
+ grid-template-columns: minmax(280px, 0.72fr) minmax(0, 1.28fr);
+ align-items: start;
+ gap: clamp(48px, 7vw, 112px);
+}
+
+.faqIntro {
+ max-width: 480px;
+}
+
+.faqIntro h2 {
+ margin-top: 16px;
+ font-family: var(--font-crt);
+ font-size: clamp(3rem, 4.6vw, 5rem);
+ font-weight: 400;
+ letter-spacing: -0.025em;
+ line-height: 0.92;
+ text-wrap: balance;
+}
+
+.faqIntro > p:last-child {
+ max-width: 440px;
+ margin-top: 28px;
+ color: var(--landing-text-muted);
+ font-size: 1rem;
+ line-height: 1.7;
+}
+
+.faqList {
+ border-top: 1px solid var(--landing-border);
+}
+
+.faqItem {
+ border-bottom: 1px solid var(--landing-border);
+}
+
+.faqItem summary {
+ display: grid;
+ min-height: 72px;
+ padding-block: 16px;
+ cursor: pointer;
+ list-style: none;
+ grid-template-columns: minmax(0, 1fr) 44px;
+ align-items: center;
+ gap: 16px;
+ color: var(--landing-text);
+ font-size: clamp(1rem, 1.35vw, 1.16rem);
+ font-weight: 600;
+ line-height: 1.45;
+ touch-action: manipulation;
+}
+
+.faqItem summary::-webkit-details-marker {
+ display: none;
+}
+
+.faqItem summary:hover {
+ color: var(--landing-accent-dim);
+}
+
+.faqItem summary:focus-visible {
+ outline: 2px solid var(--landing-text);
+ outline-offset: 4px;
+}
+
+.faqMarker {
+ display: grid;
+ width: 44px;
+ height: 44px;
+ place-items: center;
+ color: var(--landing-accent);
+ font-family: var(--font-mono);
+ font-size: 1.2rem;
+ font-weight: 400;
+}
+
+.faqMarker::before {
+ content: "+";
+}
+
+.faqItem[open] .faqMarker::before {
+ content: "−";
+}
+
+.faqAnswer {
+ max-width: 65ch;
+ padding: 0 60px 32px 0;
+ color: var(--landing-text-muted);
+ font-size: 0.96rem;
+ line-height: 1.75;
+}
+
.closingCta {
position: relative;
isolation: isolate;
@@ -1178,13 +1280,15 @@
@media (min-width: 640px) and (max-width: 819px) {
.productLayout,
- .ownershipInner {
+ .ownershipInner,
+ .faqLayout {
grid-template-columns: 1fr;
gap: 56px;
}
.productLayout .sectionIntro,
- .identityLayout .sectionIntro {
+ .identityLayout .sectionIntro,
+ .faqIntro {
max-width: 760px;
}
@@ -1281,6 +1385,10 @@
scroll-margin-top: 64px;
}
+ .faqSection {
+ scroll-margin-top: 64px;
+ }
+
.heroGrid {
grid-template-columns: 1fr;
gap: 16px;
@@ -1326,10 +1434,28 @@
.identitySection,
.timelineSection,
.reachSection,
+ .faqSection,
.closingSection {
padding: 88px 24px;
}
+ .faqLayout {
+ grid-template-columns: 1fr;
+ gap: 40px;
+ }
+
+ .faqIntro h2 {
+ font-size: clamp(3rem, 15vw, 4.5rem);
+ }
+
+ .faqItem summary {
+ min-height: 80px;
+ }
+
+ .faqAnswer {
+ padding-right: 0;
+ }
+
.sectionIntro {
margin-bottom: 40px;
}
diff --git a/src/web/src/components/home/landing-page.tsx b/src/web/src/components/home/landing-page.tsx
index 9517fc595..b5d6c2c77 100644
--- a/src/web/src/components/home/landing-page.tsx
+++ b/src/web/src/components/home/landing-page.tsx
@@ -8,6 +8,7 @@ import { ProfileCard } from "@/components/community/social/profile-card"
import { ProviderLogo } from "@/components/provider-logo"
import { HeroSection } from "./hero-section"
import { HeroAvatarSwarm } from "./hero-avatar-swarm"
+import { HomepageFaq } from "./homepage-faq"
import { LandingReachMotion } from "./landing-reach-motion"
import { LandingShellMotion } from "./landing-shell-motion"
import { MarketingNav } from "./marketing-nav"
@@ -355,6 +356,8 @@ export function LandingPage({ isLoggedIn }: { isLoggedIn: boolean }) {
</div>
</section>
+ <HomepageFaq />
+
<section className={styles.closingSection} data-testid="landing-closing">
<div className={styles.closingCta}>
<p className={styles.kicker}>Ready to share</p>