+ <>
-
{getPageTitle('Starter Page')}
+
{getPageTitle('PulseSurvey')}
+
+
+
+
+
+
+
+
+
+
PulseSurvey
+
Continuous engagement intelligence
+
+
+
+
-
-
- {contentType === 'image' && contentPosition !== 'background'
- ? imageBlock(illustrationImage)
- : null}
- {contentType === 'video' && contentPosition !== 'background'
- ? videoBlock(illustrationVideo)
- : null}
-
-
-
-
+
+
+
+
+
+ Spot burnout risk early, launch better pulse surveys, and turn feedback into action.
+
+
+ PulseSurvey helps People Ops teams run modern engagement surveys, monitor response momentum, and generate
+ crisp AI summaries with recommended next steps — all from one polished admin workspace.
+
+
+
+
+ {[
+ ['4 launch templates', 'Weekly pulse, onboarding, quarterly deep dive, burnout checks'],
+ ['AI-ready insights', 'Sentiment, top themes, risk flags, and actions'],
+ ['Multi-tenant foundation', 'Organizations, workspaces, teams, and roles already seeded'],
+ ].map(([title, description]) => (
+
+
{title}
+
{description}
+
+ ))}
+
+
-
-
-
+
+
+
Inside the MVP
+
Your first complete workflow
+
+
+
+
+ {[
+ {
+ title: '1. Launch a pulse survey',
+ text: 'Choose a proven template, set cadence + visibility, and create the survey with seeded questions in one action.',
+ },
+ {
+ title: '2. Review recent survey health',
+ text: 'See response rate, invitations, question count, department participation, and quick links to view/edit details.',
+ },
+ {
+ title: '3. Generate AI analysis',
+ text: 'Turn completed responses into themes, risk signals, and recommended actions ready for leadership readouts.',
+ },
+ ].map((item) => (
+
+
{item.title}
+
{item.text}
+
+ ))}
+
+
+
+
+
+
+
Survey templates
+
Launch modes HR teams actually use
+
+
+ Log in to build and manage surveys →
+
+
+ {landingTemplates.map((template) => (
+
+
+
{template.description}
+
+ ))}
+
+
+
+
+
+
+
+
Ready to try the admin experience?
+
+ Use the admin interface to launch surveys, inspect recent activity, and generate AI insights from within the secured workspace.
+
+
+
+
+
+
+
-
© 2026 {title} . All rights reserved
-
- Privacy Policy
-
-
+
);
}
Starter.getLayout = function getLayout(page: ReactElement) {
return
{page} ;
};
-
diff --git a/frontend/src/pages/pulse-hq.tsx b/frontend/src/pages/pulse-hq.tsx
new file mode 100644
index 0000000..50675d7
--- /dev/null
+++ b/frontend/src/pages/pulse-hq.tsx
@@ -0,0 +1,936 @@
+import {
+ mdiArrowRight,
+ mdiBrain,
+ mdiChartLine,
+ mdiClipboardTextClockOutline,
+ mdiCreation,
+ mdiLightningBolt,
+ mdiRobotOutline,
+ mdiShieldCheck,
+ mdiTarget,
+} from '@mdi/js';
+import Head from 'next/head';
+import Link from 'next/link';
+import React, { ReactElement, useEffect, useMemo, useState } from 'react';
+import axios from 'axios';
+import BaseButton from '../components/BaseButton';
+import BaseIcon from '../components/BaseIcon';
+import CardBox from '../components/CardBox';
+import LayoutAuthenticated from '../layouts/Authenticated';
+import NotificationBar from '../components/NotificationBar';
+import SectionMain from '../components/SectionMain';
+import SectionTitleLineWithButton from '../components/SectionTitleLineWithButton';
+import { getPageTitle } from '../config';
+import { hasPermission } from '../helpers/userPermissions';
+import { useAppSelector } from '../stores/hooks';
+
+type TemplateSummary = {
+ key: string;
+ title: string;
+ accent: string;
+ description: string;
+ defaultCadence: string;
+ defaultVisibility: string;
+ questionCount: number;
+ previewQuestions: Array<{
+ prompt: string;
+ question_type: string;
+ }>;
+};
+
+type RecentSurvey = {
+ id: string;
+ title: string;
+ description: string;
+ status: string;
+ visibility: string;
+ cadence: string;
+ opens_at: string | null;
+ closes_at: string | null;
+ createdAt: string;
+ templateName: string;
+ questionCount: number;
+ responseCount: number;
+ invitationCount: number;
+ responseRate: number;
+ latestAnalysisAt: string | null;
+ latestAnalysisScore: number | null;
+};
+
+type LaunchpadSummary = {
+ overview: {
+ totalSurveys: number;
+ activeSurveys: number;
+ totalResponses: number;
+ totalInvitations: number;
+ responseRate: number;
+ aiReadyCount: number;
+ activeDepartmentCount: number;
+ };
+ templates: TemplateSummary[];
+ recentSurveys: RecentSurvey[];
+ responseTrend: Array<{
+ key: string;
+ label: string;
+ count: number;
+ }>;
+ departmentBreakdown: Array<{
+ id: string;
+ name: string;
+ responseCount: number;
+ }>;
+};
+
+type AnalysisResult = {
+ overallSentimentScore: number | null;
+ executiveSummary: string;
+ topThemes: Array<{
+ theme: string;
+ confidence: string;
+ quote: string;
+ insight: string;
+ }>;
+ departmentRisks: Array<{
+ department: string;
+ riskLevel: string;
+ riskScore: number;
+ signal: string;
+ }>;
+ recommendedActions: Array<{
+ title: string;
+ owner: string;
+ timeline: string;
+ template: string;
+ }>;
+};
+
+const cadenceLabels: Record
= {
+ one_time: 'One-time',
+ weekly: 'Weekly',
+ biweekly: 'Biweekly',
+ monthly: 'Monthly',
+ quarterly: 'Quarterly',
+};
+
+const visibilityLabels: Record = {
+ anonymous: 'Anonymous',
+ identified: 'Identified',
+};
+
+const statusClassNames: Record = {
+ draft: 'bg-slate-500/15 text-slate-200',
+ scheduled: 'bg-sky-500/15 text-sky-200',
+ sending: 'bg-violet-500/15 text-violet-200',
+ active: 'bg-emerald-500/15 text-emerald-200',
+ closed: 'bg-amber-500/15 text-amber-200',
+ archived: 'bg-zinc-500/15 text-zinc-300',
+};
+
+const questionTypeLabels: Record = {
+ rating_1_10: '1–10 rating',
+ multiple_choice: 'Multiple choice',
+ open_text: 'Open text',
+ emoji_reaction: 'Emoji reaction',
+};
+
+const getDefaultTitle = (template?: TemplateSummary) => {
+ if (!template) {
+ return '';
+ }
+
+ const today = new Date().toLocaleDateString('en-US', {
+ month: 'short',
+ day: 'numeric',
+ });
+
+ return `${template.title} • ${today}`;
+};
+
+const PulseHQPage = () => {
+ const { currentUser } = useAppSelector((state) => state.auth);
+ const canCreateSurveys = Boolean(currentUser && hasPermission(currentUser, 'CREATE_SURVEYS'));
+
+ const [summary, setSummary] = useState(null);
+ const [loading, setLoading] = useState(true);
+ const [pageError, setPageError] = useState('');
+ const [selectedTemplateKey, setSelectedTemplateKey] = useState('weekly_pulse');
+ const [launching, setLaunching] = useState(false);
+ const [launchError, setLaunchError] = useState('');
+ const [launchSuccess, setLaunchSuccess] = useState(null);
+ const [selectedSurveyId, setSelectedSurveyId] = useState('');
+ const [analysisLoading, setAnalysisLoading] = useState(false);
+ const [analysisError, setAnalysisError] = useState('');
+ const [analysisResult, setAnalysisResult] = useState(null);
+ const [form, setForm] = useState({
+ templateKey: 'weekly_pulse',
+ title: '',
+ description: '',
+ cadence: 'weekly',
+ visibility: 'anonymous',
+ opens_at: '',
+ closes_at: '',
+ include_open_text: true,
+ });
+
+ const selectedTemplate = useMemo(
+ () => summary?.templates.find((template) => template.key === selectedTemplateKey) || null,
+ [selectedTemplateKey, summary?.templates],
+ );
+
+ const loadSummary = async (preferredSurveyId?: string) => {
+ try {
+ setLoading(true);
+ setPageError('');
+ const response = await axios.get('/surveys/launchpad/summary');
+ const nextSummary = response.data as LaunchpadSummary;
+ setSummary(nextSummary);
+ setSelectedSurveyId((current) => {
+ if (preferredSurveyId) {
+ return preferredSurveyId;
+ }
+ if (current && nextSummary.recentSurveys.some((survey) => survey.id === current)) {
+ return current;
+ }
+ return nextSummary.recentSurveys[0]?.id || '';
+ });
+ setSelectedTemplateKey((current) => {
+ if (nextSummary.templates.some((template) => template.key === current)) {
+ return current;
+ }
+ return nextSummary.templates[0]?.key || 'weekly_pulse';
+ });
+ setForm((current) => {
+ const template =
+ nextSummary.templates.find((item) => item.key === current.templateKey) || nextSummary.templates[0];
+
+ return {
+ ...current,
+ templateKey: template?.key || current.templateKey,
+ cadence: current.cadence || template?.defaultCadence || 'weekly',
+ visibility: current.visibility || template?.defaultVisibility || 'anonymous',
+ description: current.description || template?.description || '',
+ title: current.title || getDefaultTitle(template),
+ };
+ });
+ } catch (error: any) {
+ console.error('Failed to load Pulse HQ summary:', error);
+ setPageError(error?.response?.data || error?.message || 'Failed to load Pulse HQ.');
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ useEffect(() => {
+ loadSummary();
+ }, []);
+
+ useEffect(() => {
+ if (!selectedTemplate) {
+ return;
+ }
+
+ setForm((current) => ({
+ ...current,
+ templateKey: selectedTemplate.key,
+ description:
+ current.description && current.templateKey === selectedTemplate.key
+ ? current.description
+ : selectedTemplate.description,
+ cadence: selectedTemplate.defaultCadence,
+ visibility: selectedTemplate.defaultVisibility,
+ title: current.title ? current.title : getDefaultTitle(selectedTemplate),
+ }));
+ }, [selectedTemplateKey, selectedTemplate?.key]);
+
+ const trendMax = useMemo(() => {
+ const counts = summary?.responseTrend.map((item) => item.count) || [];
+ return Math.max(...counts, 1);
+ }, [summary?.responseTrend]);
+
+ const selectedSurvey = useMemo(
+ () => summary?.recentSurveys.find((survey) => survey.id === selectedSurveyId) || null,
+ [selectedSurveyId, summary?.recentSurveys],
+ );
+
+ const handleFieldChange = (
+ event: React.ChangeEvent,
+ ) => {
+ const { name, value, type } = event.target;
+ const nextValue = type === 'checkbox' ? (event.target as HTMLInputElement).checked : value;
+ setForm((current) => ({
+ ...current,
+ [name]: nextValue,
+ }));
+ };
+
+ const handleTemplateSelect = (templateKey: string) => {
+ setSelectedTemplateKey(templateKey);
+ const template = summary?.templates.find((item) => item.key === templateKey);
+ if (!template) {
+ return;
+ }
+
+ setForm((current) => ({
+ ...current,
+ templateKey,
+ cadence: template.defaultCadence,
+ visibility: template.defaultVisibility,
+ description: template.description,
+ title: getDefaultTitle(template),
+ }));
+ };
+
+ const handleLaunch = async (event: React.FormEvent) => {
+ event.preventDefault();
+ setLaunchError('');
+ setLaunchSuccess(null);
+ setAnalysisError('');
+
+ if (!form.title.trim()) {
+ setLaunchError('Give this launch a clear title so your team recognizes it in the dashboard.');
+ return;
+ }
+
+ if (form.opens_at && form.closes_at && new Date(form.opens_at) > new Date(form.closes_at)) {
+ setLaunchError('Choose a close date that comes after the open date.');
+ return;
+ }
+
+ try {
+ setLaunching(true);
+ const response = await axios.post('/surveys/launchpad/create', form);
+ const payload = response.data;
+ setLaunchSuccess({
+ surveyId: payload.survey.id,
+ title: payload.survey.title,
+ questionCount: payload.questionCount,
+ templateTitle: payload.template.title,
+ });
+ setAnalysisResult(null);
+ await loadSummary(payload.survey.id);
+ } catch (error: any) {
+ console.error('Failed to launch survey:', error);
+ setLaunchError(error?.response?.data || error?.message || 'Survey launch failed.');
+ } finally {
+ setLaunching(false);
+ }
+ };
+
+ const handleGenerateAnalysis = async (surveyId: string) => {
+ if (!surveyId) {
+ setAnalysisError('Pick a survey with responses before generating AI analysis.');
+ return;
+ }
+
+ try {
+ setAnalysisLoading(true);
+ setAnalysisError('');
+ const response = await axios.post(`/surveys/${surveyId}/pulse-analysis`);
+ setAnalysisResult(response.data.analysis);
+ await loadSummary(surveyId);
+ } catch (error: any) {
+ console.error('Failed to generate AI analysis:', error);
+ setAnalysisError(
+ error?.response?.data || error?.message || 'AI analysis could not be generated right now.',
+ );
+ } finally {
+ setAnalysisLoading(false);
+ }
+ };
+
+ return (
+ <>
+
+ {getPageTitle('Pulse HQ')}
+
+
+
+
+
+ {pageError && (
+
+ {pageError}
+
+ )}
+
+ {launchSuccess && (
+
+
+
+
+
+
Recent launches
+
Survey list + detail shortcuts
+
+
+
+ Loading recent survey activity…
+
+ )}
+
+ {!loading && (summary?.recentSurveys || []).length === 0 && (
+
+ No surveys yet. Launch your first pulse above and it will appear here instantly.
+
+ )}
+
+
+ {(summary?.recentSurveys || []).map((survey) => (
+
+
+
+
+
{survey.title}
+
+ {survey.status}
+
+
+
+ {survey.description || `${survey.templateName} survey ready for audience and invitation setup.`}
+
+
+
+
+
+
+
+ {[
+ ['Questions', survey.questionCount],
+ ['Responses', survey.responseCount],
+ ['Invitations', survey.invitationCount],
+ ['Response rate', `${survey.responseRate}%`],
+ ].map(([label, value]) => (
+
+ ))}
+
+
+
+
+ {cadenceLabels[survey.cadence] || survey.cadence}
+ {visibilityLabels[survey.visibility] || survey.visibility}
+
+ {survey.opens_at
+ ? `Opens ${new Date(survey.opens_at).toLocaleDateString()}`
+ : `Created ${new Date(survey.createdAt).toLocaleDateString()}`}
+
+
+ {survey.latestAnalysisAt
+ ? `Last AI run ${new Date(survey.latestAnalysisAt).toLocaleDateString()}`
+ : 'No AI analysis yet'}
+
+
+
+
+
+
+ ))}
+
+
+
+
+
+
AI insights
+
Generate executive-ready analysis
+
+
+
+ Use the currently selected survey to synthesize sentiment, themes, burnout risk, and recommended actions.
+
+
+
+
+ Survey focus
+ setSelectedSurveyId(event.target.value)}
+ >
+ {(summary?.recentSurveys || []).map((survey) => (
+
+ {survey.title}
+
+ ))}
+
+
+
+
+ {selectedSurvey
+ ? `${selectedSurvey.responseCount} responses across ${selectedSurvey.questionCount} questions.`
+ : 'Pick a survey to begin.'}
+
+
handleGenerateAnalysis(selectedSurveyId)}
+ disabled={analysisLoading || !selectedSurveyId}
+ />
+
+
+ {analysisError}
+
+ )}
+
+ {!analysisResult && !analysisLoading && !analysisError && (
+
+ Your AI summary will appear here after you run the analysis.
+
+ )}
+
+ {analysisLoading && (
+
+ Reviewing survey answers, clustering themes, and drafting next-step recommendations…
+
+ )}
+
+ {analysisResult && (
+
+
+
+
+
Overall sentiment
+
+ {analysisResult.overallSentimentScore ?? '—'}
+ / 100
+
+
+
+ {analysisResult.executiveSummary}
+
+
+
+
+
+
Top themes
+ {analysisResult.topThemes.map((theme, index) => (
+
+
+
{theme.theme}
+
+ {theme.confidence}
+
+
+
{theme.insight}
+ {theme.quote &&
“{theme.quote}” }
+
+ ))}
+
+
+
+
+
Department risk
+ {analysisResult.departmentRisks.map((risk, index) => (
+
+
+
{risk.department}
+
+ {risk.riskLevel} · {risk.riskScore}
+
+
+
{risk.signal}
+
+ ))}
+
+
+
Recommended actions
+ {analysisResult.recommendedActions.map((action, index) => (
+
+
{action.title}
+
{action.template}
+
+ Owner: {action.owner}
+ Timeline: {action.timeline}
+
+
+ ))}
+
+
+
+