Improve Frontend Onboarding Experience
Improve Frontend Onboarding Experience
Agent
OpenCode
Model
GPT-5.3 Codex
Shared
Feb 17, 5:28 PM
Messages478
Downloads15
Lets create a worktree and project to improve onboarding in the frontend
We're going to do the following
Planning worktree creation and task breakdown
git worktree list/Users/tarunsachdeva/code/traces 0ceb30f [main] /Users/tarunsachdeva/code/traces-worktrees/feat-cli-trace-index-rebuild 869ae1c [feat/cli-trace-index-rebuild] /Users/tarunsachdeva/code/traces-worktrees/feat-direct-link-visibility 4234746 [feat/direct-link-visibility] /Users/tarunsachdeva/code/traces-worktrees/feat-issue-88-nightly-db-backups 2984382 [feat/issue-88-nightly-db-backups] /Users/tarunsachdeva/code/traces-worktrees/feat-namespace-settings 540153b [feat/namespace-settings] /Users/tarunsachdeva/code/traces-worktrees/feat-nixos-support 3c23925 [feat/nixos-support] /Users/tarunsachdeva/code/traces-worktrees/feat-opencode-sqlite-adapter 543cb27 [feat/opencode-sqlite-adapter] /Users/tarunsachdeva/code/traces-worktrees/feat-pi-adapter 2afb095 [feat/pi-adapter] /Users/tarunsachdeva/code/traces-worktrees/feat-sentry-setup 0ceb30f [feat/sentry-setup] /Users/tarunsachdeva/code/traces-worktrees/feat-share-to-traces-skills 1a5e7b6 [feat/share-to-traces-skills] /Users/tarunsachdeva/code/traces-worktrees/fix-ai-summary-post-processing 8b22f9d [fix/ai-summary-post-processing] /Users/tarunsachdeva/code/traces-worktrees/fix-message-rendering 0819432 [fix/message-rendering]
Reviewing frontend instructions
Planning proactive skill loading
lsfeat-cli-trace-index-rebuild feat-direct-link-visibility feat-issue-88-nightly-db-backups feat-namespace-settings feat-nixos-support feat-opencode-sqlite-adapter feat-pi-adapter feat-sentry-setup feat-share-to-traces-skills fix-ai-summary-post-processing fix-message-rendering opencode-beta-project
Planning branch and tasks
[
{
"id": "t1",
"content": "Create a dedicated git worktree/branch for onboarding frontend work",
"status": "in_progress",
"priority": "high"
},
{
"id": "t2",
"content": "Inspect current frontend pages/components for login, profile cards, home hero, and profile traces routes",
"status": "pending",
"priority": "high"
},
{
"id": "t3",
"content": "Implement reusable/configurable onboarding wizard with dynamic completion states",
"status": "pending",
"priority": "high"
},
{
"id": "t4",
"content": "Update logged-in home behavior (hide hero, render responsive onboarding wizard)",
"status": "pending",
"priority": "high"
},
{
"id": "t5",
"content": "Fix profile routes so /[slug] shows graph + recent traces and /[slug]/traces shows full list",
"status": "pending",
"priority": "high"
},
{
"id": "t6",
"content": "Run frontend validation (lint/build or targeted checks) and summarize changes",
"status": "pending",
"priority": "medium"
}
]git worktree add -b feat/frontend-onboarding /Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding mainPreparing worktree (new branch 'feat/frontend-onboarding') HEAD is now at 0ceb30f fix(frontend): align highlights loading state with summary
Creating new worktree branch
Tracking task status updates
[
{
"id": "t1",
"content": "Create a dedicated git worktree/branch for onboarding frontend work",
"status": "completed",
"priority": "high"
},
{
"id": "t2",
"content": "Inspect current frontend pages/components for login, profile cards, home hero, and profile traces routes",
"status": "in_progress",
"priority": "high"
},
{
"id": "t3",
"content": "Implement reusable/configurable onboarding wizard with dynamic completion states",
"status": "pending",
"priority": "high"
},
{
"id": "t4",
"content": "Update logged-in home behavior (hide hero, render responsive onboarding wizard)",
"status": "pending",
"priority": "high"
},
{
"id": "t5",
"content": "Fix profile routes so /[slug] shows graph + recent traces and /[slug]/traces shows full list",
"status": "pending",
"priority": "high"
},
{
"id": "t6",
"content": "Run frontend validation (lint/build or targeted checks) and summarize changes",
"status": "pending",
"priority": "medium"
}
]Planning page file discovery
Expanding glob pattern for slug pages
Planning multi-file inspection
Inspecting profile-related card styles
Checking reusable card styles
Found 1 matches /Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/[slug]/page.tsx: Line 214: <div className="rounded-lg ring-1 ring-black/7 shadow bg-card p-4 md:-mt-16 relative z-10">
Mapping login and profile state logic
Found 100 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/tests/v1/oauth-cli.test.ts:
Line 466: test("login_slug_auto_skips_without_provider_identity", async () => {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/tests/v1/helpers.ts:
Line 197: const identityId = await client.mutation("internal/auth:ensureDeviceIdentity", {
Line 202: return { identityId, deviceId };
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/tests/v1/identities.test.ts:
Line 10: test("identity_list_all: GET /v1/identities returns all identities", async () => {
Line 14: const response = await request("GET", "/v1/identities", { token });
Line 17: expect(Array.isArray(response.body.data.identities)).toBe(true);
Line 18: expect(response.body.data.identities.length).toBeGreaterThanOrEqual(1);
Line 19: expect(response.body.data.identities.some((i: any) => i.type === "device")).toBe(true);
Line 20: expect(response.body.data.identities[0].id).toBeDefined();
Line 23: test("identity_list_unauthorized: GET /v1/identities without auth returns 401", async () => {
Line 24: const response = await request("GET", "/v1/identities");
Line 28: test("identity_remove_last_blocked: cannot remove last identity", async () => {
Line 32: const listResponse = await request("GET", "/v1/identities", { token });
Line 33: const deviceIdentity = listResponse.body.data.identities.find((i: any) => i.type === "device");
Line 35: const response = await request("DELETE", `/v1/identities/${deviceIdentity.id}`, { token });
Line 40: test("identity_remove_not_owner: non-owner cannot remove identity", async () => {
Line 44: const listResponse = await request("GET", "/v1/identities", {
Line 47: const identity = listResponse.body.data.identities[0];
Line 49: const response = await request("DELETE", `/v1/identities/${identity.id}`, {
Line 56: test("identity_remove_current_session_blocked: cannot remove identity used by current session", async () => {
Line 63: const listResponse = await request("GET", "/v1/identities", { token });
Line 65: const identities = listResponse.body.data.identities;
Line 66: expect(identities.length).toBeGreaterThanOrEqual(2);
Line 68: const currentIdentity = identities.find(
Line 69: (identity: any) =>
Line 70: identity.type === "device" && identity.externalId === deviceId
Line 74: const response = await request("DELETE", `/v1/identities/${currentIdentity.id}`, { token });
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/sessions.ts:
Line 112: identityId: asId<"identities">(sessionAuth.identityId),
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/identities.ts:
Line 11: _id: Id<"identities">;
Line 25: const identities = await ctx.runQuery(internal.internal.identities.listForUser, {
Line 30: identities: identities.map((identity: IdentityListItem) => ({
Line 31: id: identity._id,
Line 32: type: identity.type,
Line 33: externalId: identity.externalId,
Line 34: email: identity.email,
Line 35: providerData: identity.providerData,
Line 36: createdAt: identity.createdAt,
Line 44: identityId: string
Line 48: const identity = await ctx.runQuery(internal.internal.identities.getById, {
Line 49: identityId: asId<"identities">(identityId),
Line 51: if (!identity) {
Line 55: if (identity.userId !== sessionAuth.userId) {
Line 59: if (identity._id === sessionAuth.identityId) {
Line 60: throw new BadRequest("Cannot remove identity used by current session");
Line 63: const count = await ctx.runQuery(internal.internal.identities.countForUser, {
Line 67: throw new BadRequest("Cannot remove last identity");
Line 70: await ctx.runMutation(internal.internal.identities.remove, {
Line 71: identityId: asId<"identities">(identity._id),
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/schema.ts:
Line 12: identities: defineTable({
Line 29: identityId: v.id("identities"),
Line 39: .index("by_identity", ["identityId"])
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/reset.ts:
Line 48: "identities",
Line 60: v.literal("identities"),
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/lib/avatars.ts:
Line 5: * Look up the GitHub avatar URL for a user by joining the identities table.
Line 15: .query("identities")
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/lib/auth.ts:
Line 14: identityId: Id<"identities">;
Line 49: identityId: session.identityId as Id<"identities">,
Line 94: identityId: session.identityId as Id<"identities">,
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/users.ts:
Line 163: * Get identities for a user
Line 169: .query("identities")
Line 176: * Delete an identity and its sessions
Line 179: args: { identityId: v.id("identities") },
Line 184: .withIndex("by_identity", (q) => q.eq("identityId", args.identityId))
Line 191: // Delete the identity
Line 192: await ctx.db.delete(args.identityId);
Line 253: // 3. Delete all identities (and their sessions)
Line 254: const identities = await ctx.runQuery(internal.internal.users._getIdentitiesForUser, {
Line 258: for (const identity of identities) {
Line 260: identityId: identity._id,
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/test_helpers.ts:
Line 146: identities: 0,
Line 226: // 5. Delete identities by userId
Line 227: const identities = await ctx.db
Line 228: .query("identities")
Line 232: for (const identity of identities) {
Line 233: await ctx.db.delete(identity._id);
Line 234: deleted.identities++;
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/identities.ts:
Line 5: * List identities for a user
Line 10: const identities = await ctx.db
Line 11: .query("identities")
Line 15: return identities.map((i) => ({
Line 27: * Count identities for a user
Line 32: const identities = await ctx.db
Line 33: .query("identities")
Line 37: return identities.length;
Line 42: * Get identity by ID
Line 45: args: { identityId: v.id("identities") },
Line 47: return ctx.db.get(args.identityId);
Line 52: * Delete an identity (and revoke its sessions)
Line 55: args: { identityId: v.id("identities") },
Line 57: // Revoke all sessions for this identity
Line 60: .withIndex("by_identity", (q) => q.eq("identityId", args.identityId))
Line 67: // Delete the identity
Line 68: await ctx.db.delete(args.identityId);
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/auth.ts:
Line 33: identityId: string;
Line 41: .query("identities")
Line 50: let identityId: string;
Line 55: identityId = existingIdentity._id as string;
Line 71: const newIdentityId = await ctx.db.insert("identities", {
Line 76: identityId = newIdentityId as string;
Line 114: identityId: asId<"identities">(existingIdentity?._id ?? identityId),
(Results are truncated. Consider using a more specific path or pattern.)Found 8 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/tests/v1/namespaces.test.ts:
Line 171: test("namespaces.getPublicTraces returns only public traces", async () => {
Line 181: const traces = await client.query("namespaces:getPublicTraces", { slug });
Line 191: test("namespaces.getAllTraces requires membership", async () => {
Line 200: const unauth = await client.query("namespaces:getAllTraces", { slug });
Line 203: const authed = await client.query("namespaces:getAllTraces", {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/namespaces.ts:
Line 14: export const getProfile = query({
Line 39: export const getPublicTraces = query({
Line 75: export const getAllTraces = query({Found 39 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/hooks/useFeed.tsx:
Line 31: isAuthenticated: boolean;
Line 36: isAuthenticated: boolean;
Line 95: isAuthenticated: data?.isAuthenticated ?? false,
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/(home)/page.tsx:
Line 12: isAuthenticated: boolean;
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/design/app/trace/[id]/actions.ts:
Line 47: const isAuthenticated = !!session?.user;
Line 66: const userId = isAuthenticated
Line 69: const userName = isAuthenticated
Line 72: const userAvatar = isAuthenticated
Line 400: const isAuthenticated = !!session?.user;
Line 402: const userId = isAuthenticated
Line 405: const userName = isAuthenticated
Line 408: const userAvatar = isAuthenticated
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/test/core/trace-controller.test.ts:
Line 538: isAuthenticated() {
Line 572: isAuthenticated() {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/test/core/upload-queue.test.ts:
Line 107: isAuthenticated() {
Line 177: isAuthenticated() {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/tui/app.tsx:
Line 16: import { getCurrentUser, isAuthenticated } from '../services/auth.js';
Line 1986: if (!isAuthenticated()) {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/services/auth.ts:
Line 45: export function isAuthenticated(): boolean {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/services/api.ts:
Line 14: import { ensureAuth, getAuthHeaders, isAuthenticated as getIsAuthenticated } from './auth.js';
Line 20: isAuthenticated(): boolean;
Line 460: isAuthenticated() {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/services/auth.test.ts:
Line 77: test("isAuthenticated_returns_false_when_not_logged_in", async () => {
Line 78: const { isAuthenticated } = await import("./auth");
Line 80: expect(isAuthenticated()).toBe(false);
Line 83: test("isAuthenticated_returns_true_when_logged_in", async () => {
Line 94: const { isAuthenticated } = await import("./auth");
Line 96: expect(isAuthenticated()).toBe(true);
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/core/trace-controller.ts:
Line 124: if (!this.api.isAuthenticated() || !this.api.isConfigured()) {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/commands/share.test.ts:
Line 53: isAuthenticated: () => true,
Line 266: createRuntime({ createApi: () => ({ isConfigured: () => true, isAuthenticated: () => false }) as any })
Line 324: createRuntime({ createApi: () => ({ isConfigured: () => false, isAuthenticated: () => true }) as any })
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/cli/src/commands/share.ts:
Line 110: if (!api.isAuthenticated()) {
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/tests/v1/feed.test.ts:
Line 167: test("response includes isAuthenticated flag", async () => {
Line 174: expect(unauthResponse.body.data.isAuthenticated).toBe(false);
Line 179: expect(authResponse.body.data.isAuthenticated).toBe(true);
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/feed.ts:
Line 25: isAuthenticated: boolean;
Line 64: isAuthenticated: true,
Line 74: isAuthenticated: false,Inspecting feed hook usage
Investigating identity API usage
Found 43 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/http/v1/namespaces.ts:
Line 17: path: "/v1/namespaces",
Line 31: path: "/v1/namespaces",
Line 47: // GET /v1/namespaces/:slug
Line 48: // GET /v1/namespaces/:slug/traces
Line 49: // GET /v1/namespaces/:slug/invites
Line 50: // GET /v1/namespaces/:slug/members
Line 52: pathPrefix: "/v1/namespaces/",
Line 65: // GET /v1/namespaces/:slug/traces
Line 78: // GET /v1/namespaces/:slug/invites (admin only)
Line 89: // GET /v1/namespaces/:slug/members
Line 100: // GET /v1/namespaces/:slug
Line 115: // POST /v1/namespaces/:slug/invites
Line 116: // POST /v1/namespaces/:slug/avatar
Line 118: pathPrefix: "/v1/namespaces/",
Line 124: // POST /v1/namespaces/:slug/avatar
Line 139: // POST /v1/namespaces/:slug/invites
Line 158: // PATCH /v1/namespaces/:slug
Line 159: // PATCH /v1/namespaces/:slug/members/:userId
Line 161: pathPrefix: "/v1/namespaces/",
Line 172: // PATCH /v1/namespaces/:slug/members/:userId
Line 190: // PATCH /v1/namespaces/:slug
Line 208: // DELETE /v1/namespaces/:slug
Line 209: // DELETE /v1/namespaces/:slug/invites/:inviteId
Line 210: // DELETE /v1/namespaces/:slug/members/:userId
Line 211: // DELETE /v1/namespaces/:slug/avatar
Line 213: pathPrefix: "/v1/namespaces/",
Line 224: // DELETE /v1/namespaces/:slug/avatar
Line 236: // DELETE /v1/namespaces/:slug/invites/:inviteId
Line 249: // DELETE /v1/namespaces/:slug/members/:userId
Line 262: // DELETE /v1/namespaces/:slug
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/http/v1/identities.ts:
Line 9: path: "/v1/identities",
Line 23: pathPrefix: "/v1/identities/",
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/http/v1/invites.ts:
Line 8: * Register invite routes that live outside the /v1/namespaces/ prefix:
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/http/v1/feed.ts:
Line 9: path: "/v1/feed",
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/http.ts:
Line 5: import { registerFeedRoutes } from "./http/v1/feed";
Line 6: import { registerIdentityRoutes } from "./http/v1/identities";
Line 9: import { registerNamespaceRoutes } from "./http/v1/namespaces";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/_generated/api.d.ts:
Line 15: import type * as http_v1_feed from "../http/v1/feed.js";
Line 16: import type * as http_v1_identities from "../http/v1/identities.js";
Line 19: import type * as http_v1_namespaces from "../http/v1/namespaces.js";
Line 78: "http/v1/feed": typeof http_v1_feed;
Line 79: "http/v1/identities": typeof http_v1_identities;
Line 82: "http/v1/namespaces": typeof http_v1_namespaces;Assessing existing feed data for onboarding states
Found 44 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/next.config.ts:
Line 4: transpilePackages: ["@traces/shared"],
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/lib/types.ts:
Line 1: // MessagePart extends the shared Part type with Convex-specific ID
Line 2: // See @traces/shared for canonical Part type definitions
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/lib/message-utils.ts:
Line 1: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/lib/filter-utils.ts:
Line 1: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/ui/primitives/Pre.tsx:
Line 21: * All variants share the same base typography and overflow handling.
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/ThinkingMessage.tsx:
Line 2: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageAccordion.tsx:
Line 12: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageList.tsx:
Line 11: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageItem.tsx:
Line 4: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/VisibilityStatusBadge.tsx:
Line 16: visibility === "public"
Line 18: : visibility === "direct"
Line 24: {visibility === "public" ? (
Line 29: ) : visibility === "direct" ? (
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/TraceGrid.tsx:
Line 27: // The user prompt says "shows when user shared how many traces similar to Github".
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/TraceRow.tsx:
Line 42: const nonPublicVisibility = visibility === "private" || visibility === "direct" ? visibility : null;
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/TraceOverview.tsx:
Line 58: shareUrl,
Line 66: shareUrl: string;
Line 95: value={shareUrl}
Line 166: aria-label={`shared ${createdAtTimeAgo}`}
Line 293: setVisibilityError("Trace not found or not shared");
Line 316: shareUrl={typeof window !== "undefined" ? `${window.location.origin}/s/${traceId}` : ""}
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/HomeFeed.tsx:
Line 41: <span>shared a trace {timeAgo.toLowerCase()}</span>
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/HomeHero.tsx:
Line 42: A new way to discover, share and collaborate on agent traces.
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/HeroImage.tsx:
Line 56: directory: "packages/shared",
Line 118: directory: "packages/shared",
Line 142: directory: "packages/shared",
Line 195: directory: "packages/shared",
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/opengraph-image.tsx:
Line 3: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/terms/page.tsx:
Line 69: Through the Traces Platform, we provide tools for developers to capture, share, and discover AI agent traces and development workflows. This includes, but is not limited to:
Line 114: to grant this license, including the right to share any code, data, or other materials
Line 136: sensitive data, secrets, or proprietary information that you do not have permission to share.
Line 279: your use or misuse of the Services, including any traces you share that contain
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/trace-layout-client.tsx:
Line 5: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/full/page.tsx:
Line 19: import { PartType } from "@traces/shared";
Line 26: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/layout.tsx:
Line 4: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/(highlights)/page.tsx:
Line 12: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/privacy/page.tsx:
Line 82: You control which traces are synced and whether they are shared publicly or kept private.
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/opengraph-image.tsx:
Line 195: A new way to discover, share and collaborate on agent traces.
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/login/page.tsx:
Line 20: Sign in to sync and share your agent traces
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/[slug]/traces/page.tsx:
Line 4: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/[slug]/settings/page.tsx:
Line 4: import { api } from "@traces/shared/convex";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/[slug]/page.tsx:
Line 4: import { api } from "@traces/shared/convex";Planning onboarding design
Evaluating auth strategy for home components
Inspecting authentication provider placement
Found 5 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/hooks/useAuthSession.tsx:
Line 25: export function AuthSessionProvider({ children }: { children: ReactNode }) {
Line 120: throw new Error("useAuthSession must be used within AuthSessionProvider");
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/layout.tsx:
Line 9: import { AuthSessionProvider } from "../hooks/useAuthSession";
Line 84: <AuthSessionProvider>
Line 90: </AuthSessionProvider>Planning full trace list implementation
Found 38 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/sessions.ts:
Line 1: import type { Api, NamespaceTypeValue, Role as RoleType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/user.ts:
Line 1: import type { Api } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/traces.ts:
Line 1: import type { Api, Role } from "@traces/shared";
Line 14: function mapTraceSummary(trace: Doc<"traces">): Api.TraceSummary {
Line 29: function mapTraceDetail(trace: Doc<"traces">, namespaceSlug: string): Api.TraceDetail {
Line 61: const traces = await ctx.runQuery(internal.internal.traces._listByNamespace, {
Line 66: return { traces: traces.map(mapTraceSummary) };
Line 74: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 108: const existing = await ctx.runQuery(internal.internal.traces._getByExternalId, {
Line 128: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, {
Line 151: const existing = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 169: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 190: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 210: const updated = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 226: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/namespaces.ts:
Line 6: } from "@traces/shared";
Line 252: export async function listNamespaceTraces(
Line 263: let traces;
Line 270: traces = await ctx.runQuery(internal.internal.traces._listByNamespace, {
Line 277: if (!traces) {
Line 278: traces = await ctx.runQuery(internal.internal.namespaces.listPublicTraces, {
Line 285: traces: traces.map((trace) => ({
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/invites.ts:
Line 6: } from "@traces/shared";
Line 347: // Delete namespace (cascades memberships + traces)
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/identities.ts:
Line 1: import type { Api } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/messages.ts:
Line 1: import type { Api, Role } from "@traces/shared";
Line 72: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId });
Line 102: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId: traceExternalId });
Line 144: const trace = await ctx.runQuery(internal.internal.traces._getByExternalId, { externalId: traceExternalId });
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/services/feed.ts:
Line 1: import type { Api } from "@traces/shared";
Line 24: traces: FeedTrace[];
Line 28: type FeedQueryTrace = Doc<"traces"> & {
Line 56: // Authenticated: return global public traces + all traces in user's namespace
Line 57: const traces = await ctx.runQuery(internal.internal.feed._listAuthenticatedFeed, {
Line 63: traces: traces.map(mapFeedTrace),
Line 67: // Unauthenticated: return global public traces only
Line 68: const traces = await ctx.runQuery(internal.internal.feed._listPublicTraces, {
Line 73: traces: traces.map(mapFeedTrace),Found 3 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/traces.ts:
Line 32: export const _listByNamespace = internalQuery({
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/namespaces.ts:
Line 109: export const listPublicTraces = internalQuery({
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/api/convex/internal/feed.ts:
Line 75: export const _listPublicTraces = internalQuery({Inspecting trace query limits
Inspecting shared types for API responses
Found 23 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/packages/shared/src/index.ts:
Line 23: // Identity types
Line 24: export { IdentityType } from './identity.js';
Line 25: export type { IdentityTypeValue, Identity } from './identity.js';
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/packages/shared/src/identity.ts:
Line 2: * Identity type constants
Line 4: export const IdentityType = {
Line 9: export type IdentityTypeValue = (typeof IdentityType)[keyof typeof IdentityType];
Line 12: * Identity - authentication method linked to a user
Line 14: export interface Identity {
Line 16: type: IdentityTypeValue;
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/packages/shared/src/api/v1/gen/types.gen.ts:
Line 24: export type IdentityType = 'device' | 'github';
Line 51: export type Identity = {
Line 53: type: IdentityType;
Line 147: export type IdentityListResponseData = {
Line 148: identities: Array<Identity>;
Line 159: export type TraceSummary = {
Line 170: export type TraceDetail = TraceSummary & {
Line 180: export type TraceListResponseData = {
Line 181: traces: Array<TraceSummary>;
Line 1189: data: TraceListResponseData;
Line 1219: data: TraceListResponseData;
Line 1510: * Identity list
Line 1514: data: IdentityListResponseData;
Line 1548: * Identity deletedConsidering shared types usage
Identifying field identity type
Designing onboarding with identity and trace checks
Assessing identity fetching for onboarding
Inspecting card styles
Found 11 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/globals.css:
Line 207: /* Use variant classes (card-contour-sm, card-contour-lg, etc.) or override --card-shadow to change the shadow */
Line 209: @utility card-contour {
Line 218: @utility card-contour-none { --card-shadow: 0 0 #0000; }
Line 219: @utility card-contour-xs { --card-shadow: var(--shadow-xs); }
Line 220: @utility card-contour-sm { --card-shadow: var(--shadow-sm); }
Line 221: @utility card-contour-md { --card-shadow: var(--shadow-md); }
Line 222: @utility card-contour-lg { --card-shadow: var(--shadow-lg); }
Line 223: @utility card-contour-xl { --card-shadow: var(--shadow-xl); }
Line 224: @utility card-contour-2xl { --card-shadow: var(--shadow-2xl); }
Line 294: /* Global focus styles — exclude [role="menu"] so card-contour box-shadow is preserved */
Line 307: /* Dropdown menu container — suppress focus outline, keep card-contour shadow */Inspecting UI components for reuse
Planning onboarding and traces UI
Checking context usage in component
<skill_content name="next-best-practices"> # Skill: next-best-practices # Next.js Best Practices Apply these rules when writing or reviewing Next.js code. ## File Conventions See [file-conventions.md](./file-conventions.md) for: - Project structure and special files - Route segments (dynamic, catch-all, groups) - Parallel and intercepting routes - Middleware rename in v16 (middleware → proxy) ## RSC Boundaries Detect invalid React Server Component patterns. See [rsc-boundaries.md](./rsc-boundaries.md) for: - Async client component detection (invalid) - Non-serializable props detection - Server Action exceptions ## Async Patterns Next.js 15+ async API changes. See [async-patterns.md](./async-patterns.md) for: - Async `params` and `searchParams` - Async `cookies()` and `headers()` - Migration codemod ## Runtime Selection See [runtime-selection.md](./runtime-selection.md) for: - Default to Node.js runtime - When Edge runtime is appropriate ## Directives See [directives.md](./directives.md) for: - `'use client'`, `'use server'` (React) - `'use cache'` (Next.js) ## Functions See [functions.md](./functions.md) for: - Navigation hooks: `useRouter`, `usePathname`, `useSearchParams`, `useParams` - Server functions: `cookies`, `headers`, `draftMode`, `after` - Generate functions: `generateStaticParams`, `generateMetadata` ## Error Handling See [error-handling.md](./error-handling.md) for: - `error.tsx`, `global-error.tsx`, `not-found.tsx` - `redirect`, `permanentRedirect`, `notFound` - `forbidden`, `unauthorized` (auth errors) - `unstable_rethrow` for catch blocks ## Data Patterns See [data-patterns.md](./data-patterns.md) for: - Server Components vs Server Actions vs Route Handlers - Avoiding data waterfalls (`Promise.all`, Suspense, preload) - Client component data fetching ## Route Handlers See [route-handlers.md](./route-handlers.md) for: - `route.ts` basics - GET handler conflicts with `page.tsx` - Environment behavior (no React DOM) - When to use vs Server Actions ## Metadata & OG Images See [metadata.md](./metadata.md) for: - Static and dynamic metadata - `generateMetadata` function - OG image generation with `next/og` - File-based metadata conventions ## Image Optimization See [image.md](./image.md) for: - Always use `next/image` over `<img>` - Remote images configuration - Responsive `sizes` attribute - Blur placeholders - Priority loading for LCP ## Font Optimization See [font.md](./font.md) for: - `next/font` setup - Google Fonts, local fonts - Tailwind CSS integration - Preloading subsets ## Bundling See [bundling.md](./bundling.md) for: - Server-incompatible packages - CSS imports (not link tags) - Polyfills (already included) - ESM/CommonJS issues - Bundle analysis ## Scripts See [scripts.md](./scripts.md) for: - `next/script` vs native script tags - Inline scripts need `id` - Loading strategies - Google Analytics with `@next/third-parties` ## Hydration Errors See [hydration-error.md](./hydration-error.md) for: - Common causes (browser APIs, dates, invalid HTML) - Debugging with error overlay - Fixes for each cause ## Suspense Boundaries See [suspense-boundaries.md](./suspense-boundaries.md) for: - CSR bailout with `useSearchParams` and `usePathname` - Which hooks require Suspense boundaries ## Parallel & Intercepting Routes See [parallel-routes.md](./parallel-routes.md) for: - Modal patterns with `@slot` and `(.)` interceptors - `default.tsx` for fallbacks - Closing modals correctly with `router.back()` ## Self-Hosting See [self-hosting.md](./self-hosting.md) for: - `output: 'standalone'` for Docker - Cache handlers for multi-instance ISR - What works vs needs extra setup ## Debug Tricks See [debug-tricks.md](./debug-tricks.md) for: - MCP endpoint for AI-assisted debugging - Rebuild specific routes with `--debug-build-paths` Base directory for this skill: file:///Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory. Note: file list is sampled. <skill_files> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/runtime-selection.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/image.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/directives.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/async-patterns.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/self-hosting.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/metadata.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/scripts.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/file-conventions.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/rsc-boundaries.md</file> <file>/Users/tarunsachdeva/code/traces/.agents/skills/next-best-practices/parallel-routes.md</file> </skill_files> </skill_content>
<skill_content name="ui-guidelines">
# Skill: ui-guidelines
# UI Guidelines
Concise rules for building accessible, fast, delightful UIs. Use MUST/SHOULD/NEVER to guide decisions.
## Interactions
### Keyboard
- MUST: Full keyboard support per [WAI-ARIA APG](https://www.w3.org/WAI/ARIA/apg/patterns/)
- MUST: Visible focus rings (`:focus-visible`; group with `:focus-within`)
- MUST: Manage focus (trap, move, return) per APG patterns
- NEVER: `outline: none` without visible focus replacement
### Targets & Input
- MUST: Hit target >=24px (mobile >=44px); if visual <24px, expand hit area
- MUST: Mobile `<input>` font-size >=16px to prevent iOS zoom
- NEVER: Disable browser zoom (`user-scalable=no`, `maximum-scale=1`)
- MUST: `touch-action: manipulation` to prevent double-tap zoom
- SHOULD: Set `-webkit-tap-highlight-color` to match design
### Forms
- MUST: Hydration-safe inputs (no lost focus/value)
- NEVER: Block paste in `<input>`/`<textarea>`
- MUST: Loading buttons show spinner and keep original label
- MUST: Enter submits focused input; in `<textarea>`, Cmd/Ctrl+Enter submits
- MUST: Keep submit enabled until request starts; then disable with spinner
- MUST: Accept free text, validate after - don't block typing
- MUST: Allow incomplete form submission to surface validation
- MUST: Errors inline next to fields; on submit, focus first error
- MUST: `autocomplete` + meaningful `name`; correct `type` and `inputmode`
- SHOULD: Disable spellcheck for emails/codes/usernames
- SHOULD: Placeholders end with `...` and show example pattern
- MUST: Warn on unsaved changes before navigation
- MUST: Compatible with password managers & 2FA; allow pasting codes
- MUST: Trim values to handle text expansion trailing spaces
- MUST: No dead zones on checkboxes/radios; label+control share one hit target
### State & Navigation
- MUST: URL reflects state (deep-link filters/tabs/pagination/expanded panels)
- MUST: Back/Forward restores scroll position
- MUST: Links use `<a>`/`<Link>` for navigation (support Cmd/Ctrl/middle-click)
- NEVER: Use `<div onClick>` for navigation
### Feedback
- SHOULD: Optimistic UI; reconcile on response; on failure rollback or offer Undo
- MUST: Confirm destructive actions or provide Undo window
- MUST: Use polite `aria-live` for toasts/inline validation
- SHOULD: Ellipsis (`...`) for options opening follow-ups ("Rename...") and loading states ("Loading...")
### Touch & Drag
- MUST: Generous targets, clear affordances; avoid finicky interactions
- MUST: Delay first tooltip; subsequent peers instant
- MUST: `overscroll-behavior: contain` in modals/drawers
- MUST: During drag, disable text selection and set `inert` on dragged elements
- MUST: If it looks clickable, it must be clickable
### Autofocus
- SHOULD: Autofocus on desktop with single primary input; rarely on mobile
## Animation
- MUST: Honor `prefers-reduced-motion` (provide reduced variant or disable)
- SHOULD: Prefer CSS > Web Animations API > JS libraries
- MUST: Animate compositor-friendly props (`transform`, `opacity`) only
- NEVER: Animate layout props (`top`, `left`, `width`, `height`)
- NEVER: `transition: all` - list properties explicitly
- SHOULD: Animate only to clarify cause/effect or add deliberate delight
- SHOULD: Choose easing to match the change (size/distance/trigger)
- MUST: Animations interruptible and input-driven (no autoplay)
- MUST: Correct `transform-origin` (motion starts where it "physically" should)
- MUST: SVG transforms on `<g>` wrapper with `transform-box: fill-box`
## Layout
- SHOULD: Optical alignment; adjust +/-1px when perception beats geometry
- MUST: Deliberate alignment to grid/baseline/edges - no accidental placement
- SHOULD: Balance icon/text lockups (weight/size/spacing/color)
- MUST: Verify mobile, laptop, ultra-wide (simulate ultra-wide at 50% zoom)
- MUST: Respect safe areas (`env(safe-area-inset-*)`)
- MUST: Avoid unwanted scrollbars; fix overflows
- SHOULD: Flex/grid over JS measurement for layout
## Content & Accessibility
- SHOULD: Inline help first; tooltips last resort
- MUST: Skeletons mirror final content to avoid layout shift
- MUST: `<title>` matches current context
- MUST: No dead ends; always offer next step/recovery
- MUST: Design empty/sparse/dense/error states
- SHOULD: Curly quotes (" "); avoid widows/orphans (`text-wrap: balance`)
- MUST: `font-variant-numeric: tabular-nums` for number comparisons
- MUST: Redundant status cues (not color-only); icons have text labels
- MUST: Accessible names exist even when visuals omit labels
- MUST: Use `...` character (not `...`)
- MUST: `scroll-margin-top` on headings; "Skip to content" link; hierarchical `<h1>`-`<h6>`
- MUST: Resilient to user-generated content (short/avg/very long)
- MUST: Locale-aware dates/times/numbers (`Intl.DateTimeFormat`, `Intl.NumberFormat`)
- MUST: Accurate `aria-label`; decorative elements `aria-hidden`
- MUST: Icon-only buttons have descriptive `aria-label`
- MUST: Prefer native semantics (`button`, `a`, `label`, `table`) before ARIA
- MUST: Non-breaking spaces: `10 MB`, `Cmd K`, brand names
## Content Handling
- MUST: Text containers handle long content (`truncate`, `line-clamp-*`, `break-words`)
- MUST: Flex children need `min-w-0` to allow truncation
- MUST: Handle empty states - no broken UI for empty strings/arrays
## Performance
- SHOULD: Test iOS Low Power Mode and macOS Safari
- MUST: Measure reliably (disable extensions that skew runtime)
- MUST: Track and minimize re-renders (React DevTools/React Scan)
- MUST: Profile with CPU/network throttling
- MUST: Batch layout reads/writes; avoid reflows/repaints
- MUST: Mutations (`POST`/`PATCH`/`DELETE`) target <500ms
- SHOULD: Prefer uncontrolled inputs; controlled inputs cheap per keystroke
- MUST: Virtualize large lists (>50 items)
- MUST: Preload above-fold images; lazy-load the rest
- MUST: Prevent CLS (explicit image dimensions)
- SHOULD: `<link rel="preconnect">` for CDN domains
- SHOULD: Critical fonts: `<link rel="preload" as="font">` with `font-display: swap`
## Dark Mode & Theming
- MUST: `color-scheme: dark` on `<html>` for dark themes
- SHOULD: `<meta name="theme-color">` matches page background
- MUST: Native `<select>`: explicit `background-color` and `color` (Windows fix)
## Hydration
- MUST: Inputs with `value` need `onChange` (or use `defaultValue`)
- SHOULD: Guard date/time rendering against hydration mismatch
## Design
- SHOULD: Layered shadows (ambient + direct)
- SHOULD: Crisp edges via semi-transparent borders + shadows
- SHOULD: Nested radii: child <= parent; concentric
- SHOULD: Hue consistency: tint borders/shadows/text toward bg hue
- MUST: Accessible charts (color-blind-friendly palettes)
- MUST: Meet contrast - prefer [APCA](https://apcacontrast.com/) over WCAG 2
- MUST: Increase contrast on `:hover`/`:active`/`:focus`
- SHOULD: Match browser UI to bg
- SHOULD: Avoid dark color gradient banding (use background images when needed)
Base directory for this skill: file:///Users/tarunsachdeva/code/traces/.agents/skills/ui-guidelines
Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.
Note: file list is sampled.
<skill_files>
</skill_files>
</skill_content>Planning skill tool usage
Checking home route layout presence
Designing onboarding step actions
Designing configurable onboarding steps
Designing generic onboarding wizard
[
{
"id": "t1",
"content": "Create a dedicated git worktree/branch for onboarding frontend work",
"status": "completed",
"priority": "high"
},
{
"id": "t2",
"content": "Inspect current frontend pages/components for login, profile cards, home hero, and profile traces routes",
"status": "completed",
"priority": "high"
},
{
"id": "t3",
"content": "Implement reusable/configurable onboarding wizard with dynamic completion states",
"status": "in_progress",
"priority": "high"
},
{
"id": "t4",
"content": "Update logged-in home behavior (hide hero, render responsive onboarding wizard)",
"status": "pending",
"priority": "high"
},
{
"id": "t5",
"content": "Fix profile routes so /[slug] shows graph + recent traces and /[slug]/traces shows full list",
"status": "pending",
"priority": "high"
},
{
"id": "t6",
"content": "Run frontend validation (lint/build or targeted checks) and summarize changes",
"status": "pending",
"priority": "medium"
}
]Checking shared type imports
Found 7 matches
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/lib/message-utils.ts:
Line 1: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/lib/filter-utils.ts:
Line 1: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/ThinkingMessage.tsx:
Line 2: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageAccordion.tsx:
Line 12: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageItem.tsx:
Line 4: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/components/messages/MessageList.tsx:
Line 11: import { PartType } from "@traces/shared";
/Users/tarunsachdeva/code/traces-worktrees/feat-frontend-onboarding/frontend/app/s/[id]/full/page.tsx:
Line 19: import { PartType } from "@traces/shared";Designing onboarding wizard component
Planning traces page rewrite
Fixing conditional hook usage and path handling
Inspecting file for lint issues
Correcting file path typo
Addressing lint and type issues
Adding session-based auth fetch
Patching login card styles
Reducing page query limits and adding full trace link
Proposing full rewrite for page
Removing conditional useMemo hooks
Verifying page hooks and data limits