mirror of https://github.com/temetro/temetro.git synced 2026-08-12 11:36:52 +00:00

Files

T

Khalid Abdi a2654a87e1 Trim sidebar to New chat/Patients/Settings; document project vision

- app-sidebar: remove the "Saved" and "Conversations" nav items (dead #
  links) and the "temetro / Clinic" team switcher; footer is now a plain
  "temetro · open source" wordmark. Keep the notifications bell. Drop the
  now-unused Bookmark/MessageSquare/Logo/TeamSwitcher imports.
- CLAUDE.md (frontend): rewrite "What this is" to match the current
  patient-records flow (/patient cards, sparklines, create/edit dialog over
  the mock fixture) and point to the project vision; note team-switcher.tsx
  is unused.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-01 21:34:00 +03:00

4.8 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

@AGENTS.md

The import above is load-bearing: this is a customized Next.js 16 with breaking changes vs. public docs. Before writing any Next.js code (routing, metadata, next/image, next/font, route handlers, config), read the relevant guide under node_modules/next/dist/docs/01-app/.

What this is

temetro — an open-source clinical "AI middleman" (see the project vision in the root ../CLAUDE.md). This app is the clinician-facing chat UI. It is UI-only — no backend, no real model call — but it now drives a working patient-records flow over a mock fixture (lib/patients.ts, in-memory, session-only):

The chat parses /patient <file#> (or a bare /<file#>) in components/chat/chat-panel.tsx and renders the record as a horizontal row of cards (components/chat/patient-cards.tsx), with small dependency-free trend sparklines (components/chat/sparkline.tsx). Each card opens a detail dialog; the Summary card has an Edit record button.
Patients can be created and edited via the shared components/chat/patient-form-dialog.tsx (mode create | edit). The "Add patient" pill in chat-input.tsx opens it; saving writes to the fixture (addPatient) and opens/updates the record in the chat.
Non-command messages still get a mock assistant reply.

The signing / patient-owned-storage / approval features described in the root vision are not built yet — the fixture is the swap point for a future API.

Commands

npm run dev      # Next dev server (Turbopack) on http://localhost:3000
npm run build    # production build (runs a full TypeScript typecheck — see caveat below)
npm run start    # serve the production build
npm run lint     # eslint (eslint-config-next: core-web-vitals + typescript)

There is no test runner configured (no test script, no vitest/jest/playwright). Don't invent test commands; verify changes by running the dev server.

Version control: this folder is its own git repo. Commit after every change (git -C . add -A && git commit), with the Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> trailer. See the root ../CLAUDE.md for the project-wide per-folder commit policy.

Architecture

Stack: Next.js 16.2.6 (App Router) · React 19 · TypeScript · Tailwind CSS v4. Path alias @/* → repo root (tsconfig.json). cn() (clsx + tailwind-merge) lives in lib/utils.ts.
app/ — App Router. app/page.tsx is the product chat page (sidebar + chat panel); app/layout.tsx forces dark mode by putting dark on <html> and loads the fonts.
components/ui/ — shadcn components, but built on Base UI (@base-ui/react), not Radix. APIs differ: composition uses the render prop and useRender/mergeProps, not asChild. Match existing files when adding/editing primitives. Config in components.json (style base-luma, baseColor neutral).
components/ai-elements/ — a large AI-chat primitive library (PromptInput, Conversation, Message, Suggestion, etc.) typed against AI SDK v6 (ai package: UIMessage, ChatStatus, FileUIPart). Note: @ai-sdk/react (useChat) is not installed — chat state is managed with local React state.
components/sidebar-02/ — the dashboard sidebar (SidebarProvider / Sidebar / SidebarInset from components/ui/sidebar.tsx). app-sidebar.tsx holds the nav config (New chat · Patients · Settings) + notifications; team-switcher.tsx exists but is no longer used.
components/chat/ — the product chat UI. chat-panel.tsx owns message state + empty/active layouts; chat-input.tsx is a bespoke (non–ai-elements) input matching a specific design.

Theming

Tailwind v4 with @theme inline and oklch CSS variables in app/globals.css (a Linear-inspired dark palette; --primary is indigo #5e6ad2). The app is dark-only. The radius scale (rounded-2xl … rounded-4xl) is derived from --radius, so those utilities are larger than stock Tailwind.

Gotchas

npm run build currently fails its typecheck on a pre-existing error in components/ai-elements/attachments.tsx (openDelay prop). npm run dev (Turbopack) is unaffected because it only compiles the imported route and doesn't typecheck the whole tree.
lucide-react@1.17 dropped brand glyphs (e.g. Github, Discord) — import them and you get a build error. Use inline SVGs instead.
A sibling ../landing-page/ directory is a copy of this app with a marketing landing page (components/landing/); it is a separate project, not part of this git repo.
Multiple lockfiles in the tree produce a harmless Turbopack "inferred workspace root" warning.

4.8 KiB Raw Blame History Unescape Escape