Skip to content

Commit e3101f7

Browse files
committed
chore: apply BRAND.md copy and remove duplicated brand guidelines
BRAND.md in usememos/.github is now the single source of truth for brand copy. Delete docs/brand-guidelines.md, point references to BRAND.md, and update the tagline, descriptions, docs introduction, llms.txt summary and the homepage social image to the approved copy.
1 parent 39f854d commit e3101f7

23 files changed

Lines changed: 62 additions & 190 deletions

File tree

‎AGENTS.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Treat it as a **Next.js 16 marketing/docs site plus an account app**. Current ac
88

99
## Branding Authority
1010

11-
Read `docs/brand-guidelines.md` before changing product messaging, taglines, default metadata, or social-preview copy. It is the authoritative messaging contract. Reuse `src/shared/lib/branding.ts` for approved brand strings.
11+
Brand positioning and approved copy live in [`BRAND.md`](https://github.com/usememos/.github/blob/main/BRAND.md) in the `usememos/.github` repository; it is the single source of truth. Do not keep brand guidelines in this repository. Read it before changing product messaging, taglines, default metadata, or social-preview copy, and reuse `src/shared/lib/branding.ts`, which copies its strings verbatim.
1212

1313
## Public Website Design Authority
1414

@@ -170,3 +170,13 @@ Use `pnpm run preview` or `pnpm run deploy:dry-run` to validate Cloudflare produ
170170
- Set `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` before building the static account routes; deploy and upload check that it is present. There are no current `CLERK_SECRET_KEY` consumers or server-side Clerk handlers. Introduce server credentials and narrowly matched auth middleware together when a feature needs them.
171171
- Ordinary builds use committed API schemas. `pnpm docs:refresh` can fall back to a local snapshot after a failed download; inspect its log before claiming a snapshot is current.
172172
- Before adding persistence or a binding, document the feature's requirements and follow `docs/architecture.md` ("Future data layer"). D1, Drizzle, KV, and Clerk user-sync webhooks are not existing infrastructure or mandatory next steps.
173+
174+
<!-- BEGIN:nextjs-agent-rules -->
175+
176+
# This is NOT the Next.js you know
177+
178+
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
179+
180+
This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
181+
182+
<!-- END:nextjs-agent-rules -->

‎DESIGN_SYSTEM.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -453,8 +453,8 @@ hover or supporting signal. Brand-filled controls MAY be used when the
453453
surrounding composition requires it, but blue MUST NOT become a default fill
454454
for every action and icon.
455455

456-
Use `HeroAccent` for display emphasis, including the Homepage's “Keep it yours.”
457-
line. Its `text-brand-600 dark:text-brand-300` treatment is the standard brand
456+
Use `HeroAccent` for display emphasis, including the second line of the
457+
Homepage tagline. Its `text-brand-600 dark:text-brand-300` treatment is the standard brand
458458
accent, not a page-specific exception.
459459

460460
Color rules:
@@ -603,7 +603,7 @@ system.
603603

604604
## 16. Content and voice
605605

606-
`docs/brand-guidelines.md` defines the approved product tagline, supporting description, and messaging constraints. Use the shared constants in `src/shared/lib/branding.ts` for brand-level copy; page-specific headings and descriptions should describe their own subject.
606+
[`BRAND.md`](https://github.com/usememos/.github/blob/main/BRAND.md) in `usememos/.github` defines the positioning and approved copy. Use the shared constants in `src/shared/lib/branding.ts` for brand-level copy; page-specific headings and descriptions should describe their own subject.
607607

608608
Words are part of the composition.
609609

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
<samp>website: [usememos.com](https://www.usememos.com)</samp>
22

3-
Brand messaging: [brand guidelines](docs/brand-guidelines.md). Visual design: [DESIGN_SYSTEM.md](DESIGN_SYSTEM.md).
3+
Brand messaging: [BRAND.md](https://github.com/usememos/.github/blob/main/BRAND.md). Visual design: [DESIGN_SYSTEM.md](DESIGN_SYSTEM.md).

‎content/docs/faq.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Common questions about running and using Memos.
55

66
## What is Memos?
77

8-
Memos is a personal timeline for quick notes: write short memos as they come, and find them later by search, tag, or date. You run it yourself, so your memos stay on the server you choose.
8+
Memos is an open-source timeline for your thoughts. Write a memo in seconds, tag it, attach files, and move on. Every memo is private by default; share one with the people you choose, or with anyone who has the link, when you want to. Your notes are yours: you keep them where you decide, nobody else reads them, and you can take them with you at any time.
99

1010
## Is Memos open source?
1111

‎content/docs/getting-started.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Getting Started
33
description: Run Memos locally with Docker, create the first admin user, and write your first memo.
44
---
55

6-
Memos is a personal timeline for quick notes: write short memos as they come, and find them later by search, tag, or date. The shortest path to a running instance is one Docker command with SQLite and a local data volume. Harden deployment and storage once the instance is up.
6+
The shortest path to a running instance is one Docker command with SQLite and a local data volume. Harden deployment and storage once the instance is up.
77

88
## Prerequisite
99

‎content/docs/index.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@ title: Documentation
33
description: Official Memos documentation — self-host with Docker, configure storage and authentication, write and find memos in Markdown, and use the API.
44
---
55

6-
Memos is a personal timeline for quick notes: write short memos as they come, and find them later by search, tag, or date. It is open source and self-hosted, so your memos stay on the server you choose. Start with Getting Started, then move into deployment, configuration, and daily use.
6+
Memos is an open-source timeline for your thoughts. Write a memo in seconds, tag it, attach files, and move on. Every memo is private by default; share one with the people you choose, or with anyone who has the link, when you want to. Your notes are yours: you keep them where you decide, nobody else reads them, and you can take them with you at any time.
7+
8+
Start with Getting Started, then move into deployment, configuration, and daily use.
79

810
The usage and configuration guides cover **0.31.0**, the latest stable release. Read the [release changelog](/changelog/0-31-0) and [0.31 upgrade notes](/docs/operations/upgrade#upgrading-to-031) before upgrading. The API reference provides separate version selections.
911

‎docs/brand-guidelines.md‎

Lines changed: 0 additions & 133 deletions
This file was deleted.

‎next-env.d.ts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
/// <reference types="next" />
22
/// <reference types="next/image-types/global" />
3-
import "./.next/types/routes.d.ts";
4-
import "./.next/types/root-params.d.ts";
3+
import "./.next/dev/types/routes.d.ts";
4+
import "./.next/dev/types/root-params.d.ts";
55

66
// NOTE: This file should not be edited
77
// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

‎scripts/smoke-test.mjs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
const baseUrl = process.env.SMOKE_BASE_URL ?? "http://localhost:8788";
22

33
const checks = [
4-
{ path: "/", type: "html", contains: "Catch a thought.", cacheControlIncludes: "s-maxage=31536000" },
4+
{ path: "/", type: "html", contains: "Your thoughts, your data,", cacheControlIncludes: "s-maxage=31536000" },
55
{
66
path: "/docs/faq",
77
type: "html",

‎src/app/(public)/(site)/brand/page.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ import { buildBreadcrumbJsonLd, buildMarketingMetadata } from "@/shared/lib/seo"
77

88
export const metadata: Metadata = buildMarketingMetadata({
99
title: "Brand",
10-
description: "Official brand assets, logos, and usage guidelines for Memos, a personal timeline for quick notes.",
10+
description: "Official brand assets, logos, and usage guidelines for Memos.",
1111
path: "/brand",
1212
});
1313

0 commit comments

Comments
 (0)