The Harbor Ledger: a local news site with sections, bylines, a breaking banner, live updates and feeds
The website for a fictional local newsroom: a newspaper-style front page, section fronts, reporter pages, a breaking news banner switched...
For each Raytha use case we take a realistic brief, hand it to an AI agent with the raytha CLI, and publish what
comes out: the site, the files behind it, and a kit you can use to rebuild it yourself. This one is a help center
for a software product.
The agent built it on a fresh Raytha 2.0.1 instance. Nobody opened the admin. Every template, content type, article, page, menu and function went in through the CLI, from files in a directory.
What was built
Orbitly is a fictional project planner for small teams, and this is its help center. The site has:
- A home page with a search box that shows matching articles as you type, topic tiles with live article counts, the most-read articles, the latest releases and a contact panel.
- Six topics, each with its own colour and icon, and a page that lists its articles in reading order.
- A search page that matches article titles, summaries and full text, and narrows results by topic and tag. Every search is a link you can bookmark or share.
- Article pages with numbered steps, tip callouts, an "On this page" outline that follows you as you scroll, previous and next links, the other articles in the topic, and related articles from other topics.
- A changelog with releases marked New, Improved or Fixed, a filter for each, a page per release and an RSS feed.
- A status page with 90 days of uptime history per component and a list of past incidents.
- A restyled 404 page that offers search instead of a dead end.
There are no accounts, forms or payments. Contact options are plain email links.
The design is a crisp product look: Manrope for headings, Inter for text, cobalt blue with a mint accent, and a deep navy hero with a faint grid and slowly orbiting rings drawn in SVG. On the right of the hero, a floating search preview shows real popular articles and the latest release. On a 390px phone the layout stacks into a single column and the search box stays front and centre.
Features, and the Raytha features behind them
| Feature | How it is built |
|---|---|
| Topics, articles and releases | Three content types from one schema document. Articles use a relationship field to their topic, a multiple select for tags, a date for last updated, numbers for reading time and order, and a checkbox for popular. Releases use a dropdown for New, Improved or Fixed. |
| 34 seed items | Content import from JSON Lines. Each article points at its topic by name. |
| Search as you type | A Raytha Function at /search.json takes ?q=, searches titles, summaries and article text through API_V1, puts title matches first and returns JSON. A few lines of script in the theme call it as you type. |
| Search results page | A list view at /articles. The Liquid template reads ?q=, ?category= and ?tag=, cleans and checks each value, and builds a filter for get_content_items, such as contains(tags,'security') and category eq '...'. |
| Related articles | The article template looks up other articles that share a tag, outside the current topic, and lists the topic's articles in order for previous and next links. |
| Topic pages | The topic template queries category eq '<id>' and sorts by the article order field. |
| Changelog and feed | A list view at /changelog with a ?kind= filter, and a second Function that serves the releases as RSS at /feeds/changelog.rss. |
| Home and status pages | Site pages built from 6 custom widget templates (search hero, topic tiles, popular articles and releases, contact panel, page header, status board). The status board's components, uptime figures and incidents are widget settings an editor can change in the admin. |
| Structured data | Each article carries TechArticle JSON-LD with its topic and last-updated date. |
| Navigation | Two menus: the main menu and a footer menu. |
The brief
This is the brief, as given to the agent.
Build a knowledge base and help center for a fictional SaaS product on a fresh Raytha instance with the
raythaCLI. No clicking around the admin.
Look and feel
- Visually impressive, with a design of its own. Display type that is well proportioned, not overly wide.
- Responsive. It has to look good on a phone as well as a desktop.
Content and pages
- Categories and articles, with search and related articles.
- Changelog or status-style touches if they fit.
- No forms that take payment.
Done means
raytha checkpasses with no broken routes.- Screenshots of the result on desktop and mobile.
- A kit in the examples repository that rebuilds the site on a fresh install.
How long it took
About 30 minutes of agent time, from an empty install to raytha check passing on every route, including the
visual design and writing the 22 articles.
Rebuild it yourself
The theme, schema, functions, seed content, page definitions and menus are in the
raytha-examples repository, with a
build.sh that rebuilds the whole site into any Raytha 2.x instance. Point it at your site with RAYTHA_URL and
RAYTHA_API_KEY and run it.
