Custom Pages
Wrap the FaceSign session with your own landing and recap pages when you generate an app through the MCP server.
When you ask the FaceSign MCP server to create a verification experience — via launch_session_ui for a hosted preview or export_app to get a runnable Next.js project — the result is a small three-screen web app:
Landing page
The first thing your user sees. It's a page you describe in plain language — its layout, copy, brand, and what (if anything) it should collect before the session. The AI agent turns that description into the page's HTML.
The FaceSign session
Your user clicks Start (or whatever you named your button), and the FaceSign verification session loads in an iframe right inside your app. The user never leaves your page.
Recap page
Once the session finishes, the user is taken to a final page. This can be as simple as a short thank-you with a confirmation, or as rich as a full verification report — it's up to you.
Describing the pages to the agent
You don't build or wire these pages yourself. You describe them — the AI generating the app produces the HTML, handles passing the flow to the session, and polls for the session result when the recap needs it.
Tell the agent things like:
- What the landing page should say, and whether it should collect any information before the session starts (e.g., a pre-filled name, a scenario the user picks from a list).
- What brand to apply — your company name, a hex colour, a logo URL, or a reference website you'd like it to take visual cues from. See Session Customization › Auto-brand from your website.
- What the recap should show — a short confirmation message, or a fuller report (transcript, per-step outcomes, an overall result banner).
If you don't specify something, the agent picks a sensible default and tells you what it chose.
Landing vs. recap — what changes between them
| Landing page | Recap page | |
|---|---|---|
| When it runs | Before the session | After the session ends |
| Main job | Set context, collect anything needed, hand off to the session | Tell the user how it went; optionally show details |
| Typical content | Heading, short intro, Start button; sometimes a form field or a choice | A confirmation line — or an outcome banner plus supporting details |
| Length | Short, conversion-oriented | Depends on the use case — one sentence or a full report |
Recap page: minimal vs. rich
The recap is where the most variation happens. Two shapes cover almost all real-world use cases:
Minimal recap. A short thank-you page that confirms the session is complete and, if relevant, tells the user what happens next ("We'll send you a confirmation email shortly."). This is what you want in production — the detailed verification result should be consumed server-side through webhooks or GET /sessions/:id, not rendered in the browser.
Rich recap. A full verification report with an outcome banner, per-step timeline, behavioural analysis cards, session transcript, and so on. This is great for demos and internal stakeholder reviews, where you want to showcase what FaceSign saw. Ask the agent for a "demo-style recap" and it will build one out.
Rich recaps are for demos, not production. They render sensitive session data — biometrics, location, behavioural signals — in the user's browser. In a production-facing app, keep the recap minimal and consume the full results server-side via webhooks or GET /sessions/:id.