Rayleigh

A minimalistic portfolio with a gallery, an About page, a blog and a contact form, edited in a CMS.

ohne
nuxt next
cms

Open the website Open the dashboard View on GitHub Build it step by step

Skip the live demo

The home page with the interior design gallery

What it shows

The parts of ohne it puts to work.

Each card opens the guide that explains it.

CMS
The CMS
Install the layer, map paths to collections, and edit pages live.
CMS
Your website
Read pages with @ohnejs/client and join the live preview.
CMS
Frameworks
The whole loop in Nuxt, Next, React, and plain HTML.
Database
Blocks
Ordered lists of mixed, reusable shapes.
Database
Collections and fields
Your data model, and the built-in field types it is made of.
Database
Rich text
Formatted text with links to addresses and records.
Dashboard
Field layouts
Rows, cards, tabs, and rules for every form the dashboard renders.
Uploads
Uploads
Install the layer, configure storage, upload and serve files.
Project
Boot files
Code that runs before the server opens.
Project
Monorepo
Your ohne app and your Nuxt or Next website in one repository.
HTTP API
The collections API
REST endpoints a collection opts into.
HTTP API
Middleware
Code that runs before the handler on every matching request.

Get it

Clone it and run it.

You need Node 26 and pnpm. The dashboard opens on 9000.

nuxt next

Terminal

git clone https://github.com/ohnejs/rayleigh-next rayleigh
cd rayleigh
pnpm install
pnpm dev

Inside

The files that do the work.

Exactly as the repository holds them.

nuxt next

apps/web/app/[[...slug]]/page.tsx

import { OhneBlocks } from '@ohnejs/next';

import { BackButton } from '../../components/BackButton';
import { ContactForm } from '../../components/blocks/ContactForm';
import { Image } from '../../components/blocks/Image';
import { PageIntro } from '../../components/blocks/PageIntro';
import { Portfolio } from '../../components/blocks/Portfolio';
import { Posts } from '../../components/blocks/Posts';
import { Prose } from '../../components/blocks/Prose';
import { Container } from '../../components/Container';
import { WrittenOn } from '../../components/WrittenOn';
import { ohne } from '../../lib/ohne';

// The title, description, share tags and canonical link, from the page's `seo` in the CMS.
export const generateMetadata = ohne.metadata;

// One page renders every path, `/` included, by asking the CMS which page the path shows.
// A redirect or a missing page answers with its own status code, so this page only renders content.
export default async function Page() {
  const { page } = await ohne.page();

  // `cms.routes` shows a post at `/blog/<slug>`, and checking `collection` narrows the record to a post.
  if (page.collection === 'Posts') {
    const post = page.record;
    const { blogPage } = await ohne.read('Settings', { select: ['blogPage'] });
    return (
      <main className="main main--bordered main--post" lang={page.locale}>
        <Container>
          <header className="post-header">
            <BackButton link={blogPage}>Blog</BackButton>
            <h1>{post.headline || post.title}</h1>
            <WrittenOn date={post.publishedAt} author={post.author} />
          </header>
        </Container>
        <OhneBlocks blocks={post.content} components={{ Image, Prose }} />
      </main>
    );
  }

  // Each block renders its own heading, so a page adds no `<h1>` of its own.
  return (
    <main className={page.record.footerBorder ? 'main main--bordered' : 'main'} lang={page.locale}>
      {/* Name a component for every block. A block the CMS adds fails `pnpm typecheck` until it has one. */}
      <OhneBlocks
        blocks={page.record.content}
        components={{ PageIntro, Portfolio, Image, Prose, Posts, ContactForm }}
      />
    </main>
  );
}

README

From the repository.

nuxt next

README.md

Tutorial

Build this site yourself, lesson by lesson, at ohne.dev/tutorials/rayleigh/next.

The same site in Nuxt lives at ohnejs/rayleigh-nuxt. Its apps/backend is identical to this one.

What it shows

Pages built from blocks. apps/backend/blocks/ holds PageIntro, Portfolio, Image, Prose, Posts and ContactForm, and apps/web/components/blocks/ one component for each. See blocks.
A blog with its own route. cms.routes in apps/backend/ohne.config.ts shows a post at /blog/<slug> and every other path as a page. One catch-all page, apps/web/app/[[...slug]]/page.tsx, renders both. See routes.
A public relation. Each post names its author from Authors, a collection anyone may read, so the website receives the whole author. See one reference.
Site settings. Settings is a singleton with the logo, the menu and the footer links, which the site's layout reads once with ohne.read. See site data and singletons.
A paginated list. The Posts block lists three posts to a page with ohne.list, takes the page from ohne.searchParams, and answers 404 past the last page. See Next.
A contact form. Messages lets any visitor create a message and nobody but an editor read one. The form sends it through a Server Action, apps/web/lib/contact.ts, with ohne.create, and shows the CMS's own message under each invalid field. See forms.
An optional spam check. Turn on reCAPTCHA v3 in Settings, and apps/backend/middleware/recaptcha.ts asks Google about each message before it is stored. The secret key is readable: false, so no read returns it. See middleware and write-only fields.
Rich text. The Prose block's editor offers only what the design has styles for. See rich text.
Uploads in a seed. apps/backend/boot/seed.ts uploads every image with putUpload, as an editor would. See uploads in server code and boot files.
The live editor. The dashboard shows the website beside the form, and updates it as you type. See the live editor.
No UI library. Dark mode follows the system until you pick a theme, with no flash on load (apps/web/lib/theme.ts). The full-screen gallery is a native <dialog> (apps/web/components/Slider.tsx), and the mobile menu a little state in apps/web/components/Header.tsx.
Plain CSS. apps/web/app/styles/ holds Rayleigh's colors, fonts and sizes as custom properties, then one stylesheet per part of the page. The fonts are self-hosted in apps/web/public/fonts/.
One monorepo. apps/backend and apps/web share one pnpm workspace. See monorepo.
Tests. apps/backend/tests/ boots the API in the test process and checks what the seed serves, who may send and read a message, and that the secret key stays secret.

Getting started

In a copy of this repository:

Terminal

pnpm install
pnpm dev

App	Address
Website	`http://localhost:3000`
Dashboard	`http://localhost:9000`
API	`http://localhost:9001`

The first pnpm dev fills the CMS with the demo and prints the admin's password. Sign in to the dashboard as admin@example.com with it.

The seed fills an empty site only, and never under NODE_ENV=production. Delete apps/backend/.data/ and apps/backend/.uploads/ to start over.

The checks:

Terminal

pnpm typecheck
pnpm test
pnpm lint
pnpm format --check

Upgrading

Bump the versions in the catalog of pnpm-workspace.yaml and follow the framework's release notes. To pick up later changes to this example, compare your copy with this repository.

Deploy

Each app deploys on its own. See deploying.

The backend deploys like any ohne app. Set SITE_URL to the website's public address.
The website builds with pnpm build and runs as pnpm --filter web start, with OHNE_API set to your API.

The seed stays out of production, so a new install starts empty. The first visit to the dashboard opens the install page, where you create the admin.

Licence and credits

MIT, see LICENSE.
The images come from the Rayleigh template by Muris Ceman, recompressed. See apps/backend/seed/CREDITS.md.
Lato and Poppins are under the SIL Open Font License. See apps/web/public/fonts/.