Skip to content

docs: add Jan Agent landing page, remove deprecated agents docs - #8463

Closed
thinhlpg wants to merge 14 commits into
devfrom
docs/jan-agent-landing
Closed

thinhlpg wants to merge 14 commits into
devfrom
docs/jan-agent-landing

Conversation

@thinhlpg

Copy link
Copy Markdown
Member

Summary

Stacked on #8455 — Jan Agent is now positioned as its own distribution, separate from Jan Desktop.

  • Adds /jan-agent: Rust-native engine, runs standalone (VM/container/terminal), Cowork UI front end.
  • Removes docs/desktop/agents.mdx, which described the old model (jan launch claude/openclaw wiring an external CLI to a locally-served model) — superseded by the native agent work. Adds a redirect from the old URL to the new page.
  • Drops two other stale "Agents" doc cards elsewhere describing an even older, unrelated concept (calendar/WhatsApp/Discord/Slack actions).
  • Repoints every nav/homepage/docs-landing link that referenced the old page; relabels the homepage CTA from "Install" to "Explore" since there's no public release yet.

Test plan

  • /jan-agent returns 200, old /docs/desktop/agents returns 404 and redirects correctly
  • All repointed links verified (nav dropdown, docs landing common-path tile, homepage CTA)
  • No console errors, unused icon imports cleaned up
  • Visual review on preview deploy

thinhlpg added 14 commits July 17, 2026 16:19
Adds product dropdown (Jan Desktop/Jan Agent), Tokamak and Research
top-level links, Company dropdown (News/Handbook/Discord), and a
Login link to tokamak.jan.ai, per goal #207 / #208.
The colored rounded panels (hero, social-tech, CTA) had no max-width,
only their inner text container did — on ultrawide displays (2560px+)
the panel stretched edge-to-edge while content stayed centered in a
1536px column, blowing up the robot art disproportionately. Cap each
panel and the app-screenshot mockup at a fixed max-width, matching
issue #213.
Fills in the remaining destinations from goal #207 so every nav link
resolves to a real (placeholder where content isn't ready yet) page:

- /tokamak: product page for the router/fusion-model/governance split
  (#208). Nav's Tokamak item now points here instead of the external
  app login, which moved to the Login button (tokamak.jan.ai).
- /research: index + Jan V1 / Jan V3 / Tokamak-1 stubs, separate from
  changelog/blog (#210).
- /docs: rebuilt as a Menlo-docs-style landing page (two section
  cards + common paths) instead of an auto-redirect to /docs/desktop.
- /docs/tokamak: new sibling section to /docs/desktop (overview,
  install, connect-agent placeholders), per #209's two-section split.
…ders

Tokamak already has a real, live docs site at tokamak.sh/docs/
(Getting Started, Developers, Admin Guide, Self-Hosting, Reference).
Drop the internal /docs/tokamak placeholder section and link out to
it directly from the docs landing page and the /tokamak product page,
rather than duplicating stub content.
Issue #208 requires "one section per product" on the homepage; it had
zero mentions of Jan Agent or Tokamak. Add a minimal product section
with a CTA each. Also tokamak.jan.ai (used for Login/"Login to
Tokamak") doesn't resolve — the real product lives at tokamak.sh,
confirmed live with a Sign In flow. Point both there instead.
Lost when the flat Docs/Changelog/Blog/Handbook menu was consolidated
into dropdowns — /blog is still a live page but had no nav entry.
Login isn't ready yet — remove it from the nav (desktop + mobile) and
the "Login to Tokamak" CTA on /tokamak. Tokamak nav item now jumps
straight to the real docs at tokamak.sh/docs/ instead of the internal
marketing page.
Menlo's /research (menloresearch/menlo.ai) uses a featured-post +
grid index and a clean article layout (date, no sidebar/TOC chrome).
Bring the same structure to Jan's research section while keeping
Jan's own design tokens: playful bordered/shadowed card for the
featured post, serif heading font, existing link/button colors —
not Menlo's flat off-white style.

Also updates the post set per direction from Alan: Jan V1, Jan V2,
Jan V3. Drop Tokamak-1 for now (not ready to mention); Jan V2/V3
bodies are intentionally empty pending real content.
Rework the /docs landing page to follow the Menlo docs template's
layout (logo badge + "Docs" title, search bar, card grid with a
footer "Read docs" link, icon-based common paths) while keeping Jan's
own tokens: brand blue icon color, serif heading, existing card
border/spacing language — not Menlo's orange/cream palette.

Cards stay as-is: Jan -> /docs/desktop (Jan's existing docs, unchanged),
Tokamak -> tokamak.sh/docs/ (external).
Only added entries that map to real existing content: About Us ->
handbook "Who We Are", Careers -> the BambooHR link already embedded
in handbook/join-us.mdx, Contact Us -> the existing /support page.
- Chevron indicator on nav items with a dropdown (Jan, Company),
  flips 180deg on hover; dropdown fades/slides in instead of an
  instant show/hide.
- Company: split News back into Changelog + Blog, drop Contact Us,
  swap the deprecated BambooHR careers link for Menlo's current Ashby
  board (jobs.ashbyhq.com/menlo).
- Fix "Jan" nav text using the active-page blue highlight even on the
  blue hero background, making it unreadable; only tint blue off the
  landing page, keep white (bold) on it.
Docs landing: replace the awkward boxed Jan badge with a single
logo + "Jan Docs" wordmark lockup (same pattern as the homepage
hero), tinted icon chips (Jan blue / Tokamak green, echoing the
homepage section palette), soft card fills, and Jan's signature
hover treatment (black border + offset shadow + lift) on cards,
search field, and common-path tiles.

Research index: bring the same card language over; featured report
gets an icon chip, date, and "Read report" footer, grid cards get
tinted fills with footer dividers and slide-in arrows.
Jan Agent is now positioned as its own distribution (separate from
Jan Desktop). Adds /jan-agent covering the Rust-native engine, running
standalone on a VM/container/terminal, and the Cowork UI front end.

Removes docs/desktop/agents.mdx, which described the old model (`jan
launch claude/openclaw` wiring an external CLI to a locally-served
model) — superseded by the native agent work. Adds a redirect from
the old URL to the new landing page, and drops two other stale
"Agents" doc cards elsewhere that described an even older, unrelated
concept.

Repoints every nav/homepage/docs-landing link that referenced the old
page, relabeling the homepage CTA from "Install" to "Explore" since
there's no public release yet.
@github-actions

Copy link
Copy Markdown
Contributor

Preview URL: https://4de709fb.docs-9ba.pages.dev

@jonathancross

Copy link
Copy Markdown

Preview URL: https://4de709fb.docs-9ba.pages.dev

Nothing loading there.

@thinhlpg
thinhlpg force-pushed the docs/website-update branch 2 times, most recently from 0245953 to 990eec7 Compare July 31, 2026 04:05
Base automatically changed from docs/website-update to goal/general-agent July 31, 2026 04:41
@thinhlpg thinhlpg closed this Aug 17, 2026
@github-project-automation github-project-automation Bot moved this to Done in Jan Aug 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants