The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
[Website] Add articles section with index and article pages, matching customers page design (#20315)
Abdullah.552016a4d079
diff --git a/packages/twenty-website-new/src/app/[locale]/articles/[slug]/page.tsx b/packages/twenty-website-new/src/app/[locale]/articles/[slug]/page.tsxnew file mode 100644index 00000000000..da2de3b5340--- /dev/null+++ b/packages/twenty-website-new/src/app/[locale]/articles/[slug]/page.tsx@@ -0,0 +1,86 @@+import type { Metadata } from 'next';+import { notFound } from 'next/navigation';+import { SOURCE_LOCALE } from 'twenty-shared/translations';++import { getPublishedArticle, getPublishedArticles } from '@/lib/articles';+import { fetchCommunityStats } from '@/lib/community/fetch-community-stats';+import { type LocaleRouteParams } from '@/lib/i18n/get-route-i18n';+import { localeToUrlSegment } from '@/lib/i18n/website-locale-segments';+import { resolveLocaleParam } from '@/lib/i18n';+import { mergeSocialLinkLabels } from '@/lib/community/merge-social-link-labels';+import { buildArticleJsonLd, buildPageMetadata, JsonLd } from '@/lib/seo';+import { Articles } from '@/sections/Articles/components';+import { Menu } from '@/sections/Menu/components';+import { MENU_DATA } from '@/sections/Menu/data';+import { theme } from '@/theme';++type ArticleSlugParams = LocaleRouteParams & { slug: string };++type ArticlePageProps = {+ params: Promise<ArticleSlugParams>;+};++export const dynamicParams = false;++export function generateStaticParams(): ArticleSlugParams[] {+ return getPublishedArticles().map((post) => ({+ locale: localeToUrlSegment(SOURCE_LOCALE),+ slug: post.slug,+ }));+}++export async function generateMetadata({+ params,+}: ArticlePageProps): Promise<Metadata> {+ const { locale: rawLocale, slug } = await params;+ const locale = resolveLocaleParam(rawLocale);+ const post = getPublishedArticle(slug);++ if (locale !== SOURCE_LOCALE || !post) {+ return { robots: { index: false, follow: false } };+ }++ return buildPageMetadata({+ locale,+ path: `/articles/${post.slug}`,+ title: {+ id: `${post.title} | Twenty Articles`,+ message: `${post.title} | Twenty Articles`,+ },+ description: { id: post.description, message: post.description },+ locales: [SOURCE_LOCALE],+ type: 'article',+ extend: { authors: [{ name: post.author }] },+ });+}++export default async function ArticlePage({ params }: ArticlePageProps) {+ const { locale: rawLocale, slug } = await params;+ const locale = resolveLocaleParam(rawLocale);+ const post = getPublishedArticle(slug);++ if (locale !== SOURCE_LOCALE || !post) {+ notFound();+ }++ const stats = await fetchCommunityStats();+ const menuSocialLinks = mergeSocialLinkLabels(MENU_DATA.socialLinks, stats);++ return (+ <>+ <JsonLd data={buildArticleJsonLd(post)} />+ <Menu.Root+ backgroundColor={theme.colors.primary.background[100]}+ scheme="primary"+ navItems={MENU_DATA.navItems}+ socialLinks={menuSocialLinks}+ >+ <Menu.Logo scheme="primary" />+ <Menu.Nav scheme="primary" navItems={MENU_DATA.navItems} />+ <Menu.Social scheme="primary" socialLinks={menuSocialLinks} />+ <Menu.Cta scheme="primary" />+ </Menu.Root>+ <Articles.Article post={post} />+ </>+ );+}diff --git a/packages/twenty-website-new/src/app/[locale]/articles/page.tsx b/packages/twenty-website-new/src/app/[locale]/articles/page.tsxnew file mode 100644index 00000000000..3064a3de78e--- /dev/null+++ b/packages/twenty-website-new/src/app/[locale]/articles/page.tsx@@ -0,0 +1,124 @@+import { notFound } from 'next/navigation';+import { SOURCE_LOCALE } from 'twenty-shared/translations';++import { HeadingPart } from '@/design-system/components';+import { getPublishedArticles } from '@/lib/articles';+import { fetchCommunityStats } from '@/lib/community/fetch-community-stats';+import { createMessageDescriptorRenderer } from '@/lib/i18n/create-message-descriptor-renderer';+import {+ getRouteI18n,+ type LocaleRouteParams,+} from '@/lib/i18n/get-route-i18n';+import { resolveLocaleParam } from '@/lib/i18n';+import { mergeSocialLinkLabels } from '@/lib/community/merge-social-link-labels';+import { Pages } from '@/lib/pages';+import { buildArticleListJsonLd, buildRouteMetadata, JsonLd } from '@/lib/seo';+import { Articles } from '@/sections/Articles/components';+import { Hero } from '@/sections/Hero/components';+import { Menu } from '@/sections/Menu/components';+import { MENU_DATA } from '@/sections/Menu/data';+import { TrustedBy } from '@/sections/TrustedBy/components';+import { TRUSTED_BY_DATA } from '@/sections/TrustedBy/data';+import { css } from '@linaria/core';++export const generateMetadata = buildRouteMetadata('articles');++const ARTICLES_HERO_BODY = {+ text: 'Ideas from the team building Twenty on open source CRM, GTM systems, and building software that lasts.',+};++const ARTICLES_TOP_BACKGROUND_COLOR = '#F4F4F4';++const pageRevealClassName = css`+ @keyframes articlesPageReveal {+ from {+ opacity: 0;+ transform: translate3d(0, 20px, 0);+ }+ to {+ opacity: 1;+ transform: translate3d(0, 0, 0);+ }+ }++ background-color: ${ARTICLES_TOP_BACKGROUND_COLOR};++ & > * {+ animation: articlesPageReveal 720ms cubic-bezier(0.22, 1, 0.36, 1) both;+ animation-delay: 80ms;+ }++ @media (prefers-reduced-motion: reduce) {+ & > * {+ animation: none;+ }+ }+`;++type ArticlesPageProps = {+ params: Promise<LocaleRouteParams>;+};++export default async function ArticlesPage({ params }: ArticlesPageProps) {+ const { locale: rawLocale } = await params;+ const locale = resolveLocaleParam(rawLocale);++ if (locale !== SOURCE_LOCALE) {+ notFound();+ }++ const [i18n, stats] = await Promise.all([+ getRouteI18n(params),+ fetchCommunityStats(),+ ]);+ const renderText = createMessageDescriptorRenderer(i18n);+ const menuSocialLinks = mergeSocialLinkLabels(MENU_DATA.socialLinks, stats);+ const posts = getPublishedArticles();++ return (+ <>+ {posts.length > 0 ? (+ <JsonLd data={buildArticleListJsonLd(posts)} />+ ) : null}+ <Menu.Root+ backgroundColor={ARTICLES_TOP_BACKGROUND_COLOR}+ scheme="primary"+ navItems={MENU_DATA.navItems}+ socialLinks={menuSocialLinks}+ >+ <Menu.Logo scheme="primary" />+ <Menu.Nav scheme="primary" navItems={MENU_DATA.navItems} />+ <Menu.Social scheme="primary" socialLinks={menuSocialLinks} />+ <Menu.Cta scheme="primary" />+ </Menu.Root>++ <div className={pageRevealClassName}>+ <Hero.Root backgroundColor={ARTICLES_TOP_BACKGROUND_COLOR}>+ <Hero.Heading page={Pages.Articles}>+ <HeadingPart fontFamily="serif">Ideas on</HeadingPart>+ <br />+ <HeadingPart fontFamily="serif">open-source</HeadingPart>{' '}+ <HeadingPart fontFamily="sans">CRM</HeadingPart>+ </Hero.Heading>+ <Hero.Body body={ARTICLES_HERO_BODY} page={Pages.Articles} />+ </Hero.Root>+ <TrustedBy.Root+ cardBackgroundColor={ARTICLES_TOP_BACKGROUND_COLOR}+ compactBottom+ >+ <TrustedBy.Separator+ renderText={renderText}+ separator={TRUSTED_BY_DATA.separator}+ />+ <TrustedBy.Logos logos={TRUSTED_BY_DATA.logos} />+ <TrustedBy.ClientCount+ label={TRUSTED_BY_DATA.clientCountLabel.text}+ renderText={renderText}+ />+ </TrustedBy.Root>+ </div>++ <Articles.Index posts={posts} />+ </>+ );+}diff --git a/packages/twenty-website-new/src/app/sitemap.ts b/packages/twenty-website-new/src/app/sitemap.tsindex 82f54bd8631..77ccac9ca16 100644--- a/packages/twenty-website-new/src/app/sitemap.ts+++ b/packages/twenty-website-new/src/app/sitemap.ts@@ -3,7 +3,10 @@ import { SOURCE_LOCALE, type AppLocale } from 'twenty-shared/translations';import { PUBLIC_APP_LOCALE_LIST, localeToUrlSegment } from '@/lib/i18n';import { getSiteUrl } from '@/lib/seo';-import { getIndexedWebsiteRoutes } from '@/lib/website-routing';+import {+ getIndexedWebsiteRoutes,+ type WebsiteRoute,+} from '@/lib/website-routing';const SITE_URL = getSiteUrl();@@ -14,9 +17,15 @@ const buildLocalizedUrl = (locale: AppLocale, path: string): string => {return `${SITE_URL}${prefix}${tail}`;};-const buildLanguageAlternates = (path: string): Record<string, string> => {+const getRouteLocales = (route: WebsiteRoute): readonly AppLocale[] =>+ route.localeMode === 'source' ? [SOURCE_LOCALE] : PUBLIC_APP_LOCALE_LIST;++const buildLanguageAlternates = (+ path: string,+ locales: readonly AppLocale[],+): Record<string, string> => {const alternates: Record<string, string> = {};- for (const locale of PUBLIC_APP_LOCALE_LIST) {+ for (const locale of locales) {alternates[locale] = buildLocalizedUrl(locale, path);}alternates['x-default'] = buildLocalizedUrl(SOURCE_LOCALE, path);@@ -27,17 +36,22 @@ const localize = (path: string,changeFrequency: MetadataRoute.Sitemap[number]['changeFrequency'],priority: number,+ locales: readonly AppLocale[],): MetadataRoute.Sitemap =>- PUBLIC_APP_LOCALE_LIST.map((locale) => ({+ locales.map((locale) => ({url: buildLocalizedUrl(locale, path),changeFrequency,priority,- alternates: { languages: buildLanguageAlternates(path) },+ alternates: { languages: buildLanguageAlternates(path, locales) },}));export default function sitemap(): MetadataRoute.Sitemap {- return getIndexedWebsiteRoutes().flatMap(- ({ path, changeFrequency, priority }) =>- localize(path, changeFrequency, priority),+ return getIndexedWebsiteRoutes().flatMap((route) =>+ localize(+ route.path,+ route.changeFrequency,+ route.priority,+ getRouteLocales(route),+ ),);}diff --git a/packages/twenty-website-new/src/content/articles/.gitkeep b/packages/twenty-website-new/src/content/articles/.gitkeepnew file mode 100644index 00000000000..8b137891791--- /dev/null+++ b/packages/twenty-website-new/src/content/articles/.gitkeep@@ -0,0 +1 @@+diff --git a/packages/twenty-website-new/src/design-system/components/MarkdownProse.tsx b/packages/twenty-website-new/src/design-system/components/MarkdownProse.tsxnew file mode 100644index 00000000000..4f0df17662c--- /dev/null+++ b/packages/twenty-website-new/src/design-system/components/MarkdownProse.tsx@@ -0,0 +1,164 @@+'use client';++import { theme } from '@/theme';+import { styled } from '@linaria/react';+import ReactMarkdown from 'react-markdown';+import remarkGfm from 'remark-gfm';++function resolveAssetUrl(url: string | undefined): string {+ if (!url) {+ return '';+ }+ if (url.startsWith('/')) {+ return url;+ }+ return url;+}++const Prose = styled.div`+ max-width: 100%;+ min-width: 0;++ h1 {+ color: ${theme.colors.primary.text[100]};+ font-size: ${theme.font.size(8)};+ font-weight: ${theme.font.weight.medium};+ line-height: 1.25;+ margin: 0;+ margin-top: ${theme.spacing(8)};++ &:first-child {+ margin-top: 0;+ }+ }++ h2 {+ color: ${theme.colors.primary.text[100]};+ font-size: ${theme.font.size(6)};+ font-weight: ${theme.font.weight.medium};+ line-height: 1.3;+ margin: 0;+ margin-top: ${theme.spacing(8)};++ &:first-child {+ margin-top: 0;+ }+ }++ h3 {+ color: ${theme.colors.primary.text[100]};+ font-size: ${theme.font.size(5)};+ font-weight: ${theme.font.weight.medium};+ line-height: 1.35;+ margin: 0;+ margin-top: ${theme.spacing(6)};+ }++ p {+ color: ${theme.colors.primary.text[80]};+ font-size: ${theme.font.size(4)};+ line-height: 1.65;+ margin: 0;+ margin-top: ${theme.spacing(4)};+ }++ ul,+ ol {+ color: ${theme.colors.primary.text[80]};+ font-size: ${theme.font.size(4)};+ line-height: 1.65;+ margin: ${theme.spacing(4)} 0 0;+ padding-left: ${theme.spacing(6)};+ }++ li {+ margin-top: ${theme.spacing(2)};+ }++ a {+ color: ${theme.colors.highlight[100]};+ text-decoration: underline;+ text-underline-offset: 2px;+ }++ code {+ background-color: ${theme.colors.primary.border[10]};+ border-radius: ${theme.radius(1)};+ font-family: ${theme.font.family.mono};+ font-size: 0.9em;+ padding: 0.1em 0.35em;+ }++ pre {+ background-color: ${theme.colors.primary.border[10]};+ border-radius: ${theme.radius(2)};+ margin-top: ${theme.spacing(4)};+ overflow: auto;+ padding: ${theme.spacing(4)};+ }++ pre code {+ background: none;+ padding: 0;+ }++ img {+ border-radius: ${theme.radius(2)};+ display: block;+ height: auto;+ margin-top: ${theme.spacing(6)};+ max-width: min(100%, 720px);+ width: auto;+ }++ hr {+ border: none;+ border-top: 1px solid ${theme.colors.primary.border[20]};+ margin: ${theme.spacing(8)} 0 0;+ }++ blockquote {+ border-left: 2px solid ${theme.colors.primary.border[40]};+ color: ${theme.colors.primary.text[60]};+ margin: ${theme.spacing(4)} 0 0;+ padding-left: ${theme.spacing(4)};+ }+`;++type MarkdownProseProps = {+ markdown: string;+};++export function MarkdownProse({ markdown }: MarkdownProseProps) {+ return (+ <Prose>+ <ReactMarkdown+ components={{+ a: ({ children, href, ...props }) => (+ <a+ href={resolveAssetUrl(href)}+ rel="noopener noreferrer"+ // oxlint-disable-next-line react/jsx-props-no-spreading -- ReactMarkdown component overrides+ {...props}+ >+ {children}+ </a>+ ),+ img: ({ alt, src, ...props }) => (+ <img+ alt={alt ?? ''}+ decoding="async"+ loading="lazy"+ src={resolveAssetUrl(src)}+ // oxlint-disable-next-line react/jsx-props-no-spreading -- ReactMarkdown component overrides+ {...props}+ />+ ),+ }}+ remarkPlugins={[remarkGfm]}+ >+ {markdown}+ </ReactMarkdown>+ </Prose>+ );+}diff --git a/packages/twenty-website-new/src/design-system/components/index.ts b/packages/twenty-website-new/src/design-system/components/index.tsindex 714301d18eb..09cf1255c44 100644--- a/packages/twenty-website-new/src/design-system/components/index.ts+++ b/packages/twenty-website-new/src/design-system/components/index.ts@@ -18,6 +18,7 @@ export type {StackAlign,StackProps,} from './Layout';+export { MarkdownProse } from './MarkdownProse';export { Modal } from './Modal';export type { ModalRootProps } from './Modal';export { StepperProgressRail } from './StepperProgressRail';diff --git a/packages/twenty-website-new/src/lib/articles/__tests__/load-local-articles.test.ts b/packages/twenty-website-new/src/lib/articles/__tests__/load-local-articles.test.tsnew file mode 100644index 00000000000..d0b48a999ba--- /dev/null+++ b/packages/twenty-website-new/src/lib/articles/__tests__/load-local-articles.test.ts@@ -0,0 +1,142 @@+import fs from 'fs';+import os from 'os';+import path from 'path';++import { loadLocalArticlesFromDirectory } from '../load-local-articles';++function createTempDirectory(): string {+ return fs.mkdtempSync(path.join(os.tmpdir(), 'twenty-articles-'));+}++function writePost(directoryPath: string, fileName: string, content: string) {+ fs.writeFileSync(path.join(directoryPath, fileName), content);+}++describe('loadLocalArticlesFromDirectory', () => {+ it('loads valid posts sorted by date descending', () => {+ const directoryPath = createTempDirectory();++ writePost(+ directoryPath,+ 'older-post.mdx',+ `---+title: Older post+description: Older description+date: 2026-01-01+tags:+ - CRM+---++Older body.`,+ );+ writePost(+ directoryPath,+ 'newer-post.mdx',+ `---+title: Newer post+description: Newer description+date: 2026-02-01+author: Twenty Team+---++Newer body.`,+ );++ const posts = loadLocalArticlesFromDirectory(directoryPath);++ expect(posts.map((post) => post.slug)).toEqual([+ 'newer-post',+ 'older-post',+ ]);+ expect(posts[0]).toMatchObject({+ author: 'Twenty Team',+ date: '2026-02-01',+ description: 'Newer description',+ draft: false,+ title: 'Newer post',+ });+ expect(posts[1].tags).toEqual(['CRM']);+ });++ it('trims tag strings after validating', () => {+ const directoryPath = createTempDirectory();++ writePost(+ directoryPath,+ 'tagged-post.mdx',+ `---+title: Tagged post+description: Tagged description+date: 2026-03-01+tags:+ - " CRM "+ - product+---++Body.`,+ );++ const posts = loadLocalArticlesFromDirectory(directoryPath);++ expect(posts[0].tags).toEqual(['CRM', 'product']);+ });++ it('fails loudly when required frontmatter is missing', () => {+ const directoryPath = createTempDirectory();++ writePost(+ directoryPath,+ 'broken-post.mdx',+ `---+title: Broken post+date: 2026-01-01+---++Body.`,+ );++ expect(() => loadLocalArticlesFromDirectory(directoryPath)).toThrow(+ 'missing "description"',+ );+ });++ it('rejects non-kebab-case slugs', () => {+ const directoryPath = createTempDirectory();++ writePost(+ directoryPath,+ 'Invalid Slug.mdx',+ `---+title: Invalid post+description: Invalid description+date: 2026-01-01+---++Body.`,+ );++ expect(() => loadLocalArticlesFromDirectory(directoryPath)).toThrow(+ 'Use lowercase kebab-case',+ );+ });++ it('rejects invalid dates', () => {+ const directoryPath = createTempDirectory();++ writePost(+ directoryPath,+ 'invalid-date.mdx',+ `---+title: Invalid date+description: Invalid date description+date: not-a-date+---++Body.`,+ );++ expect(() => loadLocalArticlesFromDirectory(directoryPath)).toThrow(+ 'has invalid date',+ );+ });+});diff --git a/packages/twenty-website-new/src/lib/articles/format-article-date.ts b/packages/twenty-website-new/src/lib/articles/format-article-date.tsnew file mode 100644index 00000000000..98be14be41e--- /dev/null+++ b/packages/twenty-website-new/src/lib/articles/format-article-date.ts@@ -0,0 +1,13 @@+export function formatArticleDate(dateString: string): string {+ const date = new Date(dateString);++ if (Number.isNaN(date.getTime())) {+ throw new Error(`Invalid article date: ${dateString}`);+ }++ return new Intl.DateTimeFormat('en-US', {+ month: 'long',+ day: 'numeric',+ year: 'numeric',+ }).format(date);+}diff --git a/packages/twenty-website-new/src/lib/articles/index.ts b/packages/twenty-website-new/src/lib/articles/index.tsnew file mode 100644index 00000000000..28d4055988f--- /dev/null+++ b/packages/twenty-website-new/src/lib/articles/index.ts@@ -0,0 +1,8 @@+export { formatArticleDate } from './format-article-date';+export {+ getPublishedArticle,+ getPublishedArticles,+ loadLocalArticles,+ loadLocalArticlesFromDirectory,+} from './load-local-articles';+export type { Article } from './types';diff --git a/packages/twenty-website-new/src/lib/articles/load-local-articles.ts b/packages/twenty-website-new/src/lib/articles/load-local-articles.tsnew file mode 100644index 00000000000..c681ec061d7--- /dev/null+++ b/packages/twenty-website-new/src/lib/articles/load-local-articles.ts@@ -0,0 +1,177 @@+import fs from 'fs';+import path from 'path';++import matter from 'gray-matter';++import type { Article } from './types';++const WORDS_PER_MINUTE = 220;++type ArticleFrontmatter = {+ author?: unknown;+ date?: unknown;+ description?: unknown;+ draft?: unknown;+ slug?: unknown;+ tags?: unknown;+ title?: unknown;+};++const ARTICLES_DIRECTORY_CANDIDATES = [+ path.join(process.cwd(), 'src', 'content', 'articles'),+ path.join(+ process.cwd(),+ 'packages',+ 'twenty-website-new',+ 'src',+ 'content',+ 'articles',+ ),+];++function resolveArticlesDirectory(): string | null {+ for (const directoryPath of ARTICLES_DIRECTORY_CANDIDATES) {+ if (fs.existsSync(directoryPath)) {+ return directoryPath;+ }+ }++ return null;+}++function normalizeDate(value: unknown, fileName: string): string {+ if (typeof value === 'string' && value.trim()) {+ if (Number.isNaN(new Date(value).getTime())) {+ throw new Error(`Article "${fileName}" has invalid date "${value}".`);+ }++ return value;+ }++ if (value instanceof Date && !Number.isNaN(value.getTime())) {+ return value.toISOString().slice(0, 10);+ }++ throw new Error(`Article "${fileName}" is missing a valid date.`);+}++function requireString(+ value: unknown,+ fieldName: keyof Pick<Article, 'description' | 'title'>,+ fileName: string,+): string {+ if (typeof value === 'string' && value.trim()) {+ return value;+ }++ throw new Error(`Article "${fileName}" is missing "${fieldName}".`);+}++function normalizeTags(value: unknown, fileName: string): readonly string[] {+ if (value === undefined) {+ return [];+ }++ if (!Array.isArray(value)) {+ throw new Error(`Article "${fileName}" has invalid "tags".`);+ }++ if (!value.every((tag) => typeof tag === 'string' && tag.trim())) {+ throw new Error(`Article "${fileName}" has invalid "tags".`);+ }++ return value.map((tag) => {+ if (typeof tag !== 'string') {+ throw new Error(`Article "${fileName}" has invalid "tags".`);+ }++ return tag.trim();+ });+}++function normalizeSlug(value: unknown, fileName: string): string {+ const slug =+ typeof value === 'string' && value.trim()+ ? value+ : fileName.replace(/\.mdx?$/i, '');++ if (/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {+ return slug;+ }++ throw new Error(+ `Article "${fileName}" has invalid slug "${slug}". Use lowercase kebab-case.`,+ );+}++function calculateReadingTimeMinutes(content: string): number {+ const wordCount = content.trim().split(/\s+/).filter(Boolean).length;++ return Math.max(1, Math.ceil(wordCount / WORDS_PER_MINUTE));+}++function parseArticle(fileName: string, raw: string): Article {+ const { content, data } = matter(raw);+ const frontmatter = data as ArticleFrontmatter;++ return {+ author:+ typeof frontmatter.author === 'string' && frontmatter.author.trim()+ ? frontmatter.author+ : 'Twenty',+ content,+ date: normalizeDate(frontmatter.date, fileName),+ description: requireString(+ frontmatter.description,+ 'description',+ fileName,+ ),+ draft: frontmatter.draft === true,+ readingTimeMinutes: calculateReadingTimeMinutes(content),+ slug: normalizeSlug(frontmatter.slug, fileName),+ tags: normalizeTags(frontmatter.tags, fileName),+ title: requireString(frontmatter.title, 'title', fileName),+ };+}++export function loadLocalArticlesFromDirectory(+ directoryPath: string,+): Article[] {+ const articles = fs+ .readdirSync(directoryPath)+ .filter((fileName) => fileName.endsWith('.md') || fileName.endsWith('.mdx'))+ .map((fileName) => {+ const raw = fs.readFileSync(path.join(directoryPath, fileName), 'utf-8');++ return parseArticle(fileName, raw);+ });++ articles.sort((article, other) => other.date.localeCompare(article.date));++ return articles;+}++let cachedArticles: Article[] | null = null;++export function loadLocalArticles(): Article[] {+ if (cachedArticles !== null) {+ return cachedArticles;+ }++ const directoryPath = resolveArticlesDirectory();+ cachedArticles = directoryPath+ ? loadLocalArticlesFromDirectory(directoryPath)+ : [];++ return cachedArticles;+}++export function getPublishedArticles(): Article[] {+ return loadLocalArticles().filter((article) => !article.draft);+}++export function getPublishedArticle(slug: string): Article | null {+ return (+ getPublishedArticles().find((article) => article.slug === slug) ?? null+ );+}diff --git a/packages/twenty-website-new/src/lib/articles/types.ts b/packages/twenty-website-new/src/lib/articles/types.tsnew file mode 100644index 00000000000..84f973023f3--- /dev/null+++ b/packages/twenty-website-new/src/lib/articles/types.ts@@ -0,0 +1,11 @@+export type Article = {+ author: string;+ content: string;+ date: string;+ description: string;+ draft: boolean;+ readingTimeMinutes: number;+ slug: string;+ tags: readonly string[];+ title: string;+};diff --git a/packages/twenty-website-new/src/lib/pages.ts b/packages/twenty-website-new/src/lib/pages.tsindex 97da0f1cc2e..2a2605cfc3a 100644--- a/packages/twenty-website-new/src/lib/pages.ts+++ b/packages/twenty-website-new/src/lib/pages.ts@@ -1,4 +1,5 @@export const Pages = {+ Articles: 'articles',CaseStudies: 'caseStudies',ReleaseNotes: 'releaseNotes',Home: 'home',diff --git a/packages/twenty-website-new/src/lib/seo/__tests__/json-ld.test.tsx b/packages/twenty-website-new/src/lib/seo/__tests__/json-ld.test.tsxindex 018af62ba65..f89dcf45094 100644--- a/packages/twenty-website-new/src/lib/seo/__tests__/json-ld.test.tsx+++ b/packages/twenty-website-new/src/lib/seo/__tests__/json-ld.test.tsx@@ -1,4 +1,6 @@import {+ buildArticleListJsonLd,+ buildArticleJsonLd,buildFaqPageJsonLd,buildOrganizationJsonLd,buildReleaseListJsonLd,@@ -166,3 +168,62 @@ describe('buildReleaseListJsonLd', () => {expect(data.itemListElement[0].item).not.toHaveProperty('datePublished');});});++describe('articles JSON-LD', () => {+ const post = {+ author: 'Twenty',+ content: 'Body',+ date: '2026-05-06',+ description: 'A practical CRM article.',+ draft: false,+ readingTimeMinutes: 3,+ slug: 'practical-crm-article',+ tags: ['CRM'],+ title: 'Practical CRM Article',+ };++ it('builds a Blog schema for the articles index', () => {+ const data = buildArticleListJsonLd([post]) as {+ '@type': string;+ blogPost: Array<Record<string, unknown>>;+ };++ expect(data).toMatchObject({+ '@type': 'Blog',+ name: 'Twenty Articles',+ url: 'https://example.test/articles',+ });+ expect(data.blogPost[0]).toMatchObject({+ '@type': 'BlogPosting',+ headline: 'Practical CRM Article',+ url: 'https://example.test/articles/practical-crm-article',+ datePublished: '2026-05-06',+ author: {+ '@type': 'Organization',+ name: 'Twenty',+ },+ });+ });++ it('builds a BlogPosting schema for an article page', () => {+ const data = buildArticleJsonLd(post);++ expect(data).toMatchObject({+ '@type': 'BlogPosting',+ headline: 'Practical CRM Article',+ description: 'A practical CRM article.',+ url: 'https://example.test/articles/practical-crm-article',+ mainEntityOfPage: 'https://example.test/articles/practical-crm-article',+ datePublished: '2026-05-06',+ author: {+ '@type': 'Organization',+ name: 'Twenty',+ },+ publisher: {+ '@type': 'Organization',+ name: 'Twenty',+ url: 'https://example.test',+ },+ });+ });+});diff --git a/packages/twenty-website-new/src/lib/seo/build-page-metadata.ts b/packages/twenty-website-new/src/lib/seo/build-page-metadata.tsindex 2a4f142b693..acc00e3aca7 100644--- a/packages/twenty-website-new/src/lib/seo/build-page-metadata.ts+++ b/packages/twenty-website-new/src/lib/seo/build-page-metadata.ts@@ -20,6 +20,7 @@ export type BuildPageMetadataInput = {path: string;title: MessageDescriptor;description: MessageDescriptor;+ locales?: readonly AppLocale[];ogImage?: string;type?: 'website' | 'article';extend?: Metadata;@@ -40,9 +41,10 @@ const localizePath = (locale: AppLocale, normalizedPath: string): string => {const buildLanguageAlternates = (normalizedPath: string,+ locales: readonly AppLocale[],): Record<string, string> => {const languages: Record<string, string> = {};- for (const locale of PUBLIC_APP_LOCALE_LIST) {+ for (const locale of locales) {languages[locale] = localizePath(locale, normalizedPath);}languages['x-default'] = localizePath(SOURCE_LOCALE, normalizedPath);@@ -54,6 +56,7 @@ export function buildPageMetadata({path,title,description,+ locales = PUBLIC_APP_LOCALE_LIST,ogImage,type = 'website',extend,@@ -83,7 +86,7 @@ export function buildPageMetadata({description: resolvedDescription,alternates: {canonical,- languages: buildLanguageAlternates(normalizedPath),+ languages: buildLanguageAlternates(normalizedPath, locales),},openGraph: {title: resolvedTitle,diff --git a/packages/twenty-website-new/src/lib/seo/build-route-metadata.ts b/packages/twenty-website-new/src/lib/seo/build-route-metadata.tsindex 8c54fa813be..7e8e7e02a93 100644--- a/packages/twenty-website-new/src/lib/seo/build-route-metadata.ts+++ b/packages/twenty-website-new/src/lib/seo/build-route-metadata.ts@@ -1,4 +1,5 @@import { WEBSITE_ROUTES, type WebsiteRouteId } from '@/lib/website-routing';+import { SOURCE_LOCALE } from 'twenty-shared/translations';import { buildLocalizedMetadata } from './build-localized-metadata';import type { BuildPageMetadataInput } from './build-page-metadata';@@ -21,6 +22,7 @@ export const buildRouteMetadata = (path: route.path,title: route.title,description: route.description,+ locales: route.localeMode === 'source' ? [SOURCE_LOCALE] : undefined,...options,});};diff --git a/packages/twenty-website-new/src/lib/seo/index.ts b/packages/twenty-website-new/src/lib/seo/index.tsindex d88747d635f..e3c863a8a56 100644--- a/packages/twenty-website-new/src/lib/seo/index.ts+++ b/packages/twenty-website-new/src/lib/seo/index.ts@@ -5,6 +5,8 @@ export {} from './build-page-metadata';export { buildRouteMetadata } from './build-route-metadata';export {+ buildArticleListJsonLd,+ buildArticleJsonLd,buildFaqPageJsonLd,buildOrganizationJsonLd,buildReleaseListJsonLd,diff --git a/packages/twenty-website-new/src/lib/seo/json-ld.tsx b/packages/twenty-website-new/src/lib/seo/json-ld.tsxindex 3e61cd2c5e6..2c01a893413 100644--- a/packages/twenty-website-new/src/lib/seo/json-ld.tsx+++ b/packages/twenty-website-new/src/lib/seo/json-ld.tsx@@ -1,5 +1,6 @@import type { MessageDescriptor } from '@lingui/core';+import type { Article } from '@/lib/articles';import type { LocalReleaseNote } from '@/lib/releases/types';import { getSiteUrl } from './site-url';@@ -135,3 +136,57 @@ export const buildReleaseListJsonLd = (})),};};++export const buildArticleListJsonLd = (+ posts: readonly Article[],+): JsonLdValue => {+ const siteUrl = getSiteUrl();+ const articlesUrl = `${siteUrl}/articles`;++ return {+ '@context': 'https://schema.org',+ '@type': 'Blog',+ name: 'Twenty Articles',+ url: articlesUrl,+ blogPost: posts.map((post) => ({+ '@type': 'BlogPosting',+ headline: post.title,+ description: post.description,+ url: `${articlesUrl}/${post.slug}`,+ datePublished: post.date,+ author: {+ '@type': 'Organization',+ name: post.author,+ },+ publisher: {+ '@type': 'Organization',+ name: 'Twenty',+ url: siteUrl,+ },+ })),+ };+};++export const buildArticleJsonLd = (post: Article): JsonLdValue => {+ const siteUrl = getSiteUrl();+ const postUrl = `${siteUrl}/articles/${post.slug}`;++ return {+ '@context': 'https://schema.org',+ '@type': 'BlogPosting',+ headline: post.title,+ description: post.description,+ url: postUrl,+ mainEntityOfPage: postUrl,+ datePublished: post.date,+ author: {+ '@type': 'Organization',+ name: post.author,+ },+ publisher: {+ '@type': 'Organization',+ name: 'Twenty',+ url: siteUrl,+ },+ };+};diff --git a/packages/twenty-website-new/src/lib/website-routing/article-routes.ts b/packages/twenty-website-new/src/lib/website-routing/article-routes.tsnew file mode 100644index 00000000000..ba1f43f8fab--- /dev/null+++ b/packages/twenty-website-new/src/lib/website-routing/article-routes.ts@@ -0,0 +1,39 @@+import { getPublishedArticles } from '@/lib/articles';++import type { WebsiteRoute } from './types';++const descriptorFromText = (message: string) => ({ id: message, message });++const publishedArticles = getPublishedArticles();++export const ARTICLE_ROUTES: readonly WebsiteRoute[] =+ publishedArticles.length === 0+ ? []+ : [+ {+ id: 'articles',+ path: '/articles',+ title: descriptorFromText(+ 'Twenty Articles | Open Source CRM Insights',+ ),+ description: descriptorFromText(+ 'Ideas from the team building Twenty on open source CRM, customer data, GTM systems, and building software that lasts.',+ ),+ changeFrequency: 'weekly',+ priority: 0.8,+ indexed: true,+ localeMode: 'source',+ },+ ...publishedArticles.map(+ (article): WebsiteRoute => ({+ id: `articles:${article.slug}`,+ path: `/articles/${article.slug}`,+ title: descriptorFromText(`${article.title} | Twenty Articles`),+ description: descriptorFromText(article.description),+ changeFrequency: 'monthly' as const,+ priority: 0.6,+ indexed: true,+ localeMode: 'source' as const,+ }),+ ),+ ];diff --git a/packages/twenty-website-new/src/lib/website-routing/index.ts b/packages/twenty-website-new/src/lib/website-routing/index.tsindex 42a5551f3c9..d002cb538a2 100644--- a/packages/twenty-website-new/src/lib/website-routing/index.ts+++ b/packages/twenty-website-new/src/lib/website-routing/index.ts@@ -1,3 +1,4 @@+export { ARTICLE_ROUTES } from './article-routes';export { CUSTOMER_STORY_ROUTES } from './customer-story-routes';export { STATIC_WEBSITE_ROUTES } from './static-website-routes';export type { WebsiteRoute, WebsiteRouteId } from './types';diff --git a/packages/twenty-website-new/src/lib/website-routing/static-website-routes.ts b/packages/twenty-website-new/src/lib/website-routing/static-website-routes.tsindex b8fd9b73d3c..be73fe438cc 100644--- a/packages/twenty-website-new/src/lib/website-routing/static-website-routes.ts+++ b/packages/twenty-website-new/src/lib/website-routing/static-website-routes.ts@@ -66,6 +66,16 @@ export const STATIC_WEBSITE_ROUTES = [priority: 0.7,indexed: true,},+ {+ id: 'articles',+ path: '/articles',+ title: msg`Twenty Articles — Open Source CRM Insights`,+ description: msg`Ideas from the team building Twenty on open source CRM, customer data, GTM systems, and building software that lasts.`,+ changeFrequency: 'daily',+ priority: 0.8,+ indexed: true,+ localeMode: 'source',+ },{id: 'privacyPolicy',path: '/privacy-policy',diff --git a/packages/twenty-website-new/src/lib/website-routing/types.ts b/packages/twenty-website-new/src/lib/website-routing/types.tsindex 7e9e22fcd1c..ed77a2a1cd4 100644--- a/packages/twenty-website-new/src/lib/website-routing/types.ts+++ b/packages/twenty-website-new/src/lib/website-routing/types.ts@@ -10,10 +10,12 @@ export type WebsiteRouteId =| 'partners'| 'releases'| 'customers'+ | 'articles'| 'privacyPolicy'| 'terms'| 'halftone'| 'enterpriseActivate'+ | `articles:${string}`| `customer:${string}`;export type WebsiteRoute = {@@ -21,6 +23,7 @@ export type WebsiteRoute = {description: MessageDescriptor;id: WebsiteRouteId;indexed: boolean;+ localeMode?: 'all' | 'source';path: string;priority: number;robotsDisallow?: boolean;diff --git a/packages/twenty-website-new/src/lib/website-routing/website-route-list.ts b/packages/twenty-website-new/src/lib/website-routing/website-route-list.tsindex 85025c3b71c..1611baecb62 100644--- a/packages/twenty-website-new/src/lib/website-routing/website-route-list.ts+++ b/packages/twenty-website-new/src/lib/website-routing/website-route-list.ts@@ -1,3 +1,4 @@+import { ARTICLE_ROUTES } from './article-routes';import { CUSTOMER_STORY_ROUTES } from './customer-story-routes';import { STATIC_WEBSITE_ROUTES } from './static-website-routes';import type { WebsiteRoute } from './types';@@ -5,4 +6,5 @@ import type { WebsiteRoute } from './types';export const WEBSITE_ROUTE_LIST: readonly WebsiteRoute[] = [...STATIC_WEBSITE_ROUTES,...CUSTOMER_STORY_ROUTES,+ ...ARTICLE_ROUTES,];diff --git a/packages/twenty-website-new/src/sections/Articles/components/Article.tsx b/packages/twenty-website-new/src/sections/Articles/components/Article.tsxnew file mode 100644index 00000000000..588639b30f4--- /dev/null+++ b/packages/twenty-website-new/src/sections/Articles/components/Article.tsx@@ -0,0 +1,121 @@+import Link from 'next/link';++import { styled } from '@linaria/react';++import { Container, MarkdownProse } from '@/design-system/components';+import { formatArticleDate, type Article as ArticleData } from '@/lib/articles';+import { theme } from '@/theme';++import { Root } from './Root';++const ArticleEl = styled.article``;++const StyledContainer = styled(Container)`+ max-width: 860px;+ padding: ${theme.spacing(20)} ${theme.spacing(6)};++ @media (min-width: ${theme.breakpoints.md}px) {+ padding: ${theme.spacing(28)} ${theme.spacing(10)};+ }+`;++const BackLink = styled(Link)`+ color: ${theme.colors.primary.text[60]};+ display: inline-flex;+ font-size: ${theme.font.size(3)};+ margin-bottom: ${theme.spacing(8)};+ text-decoration: none;++ &:hover {+ color: ${theme.colors.primary.text[100]};+ }+`;++const Header = styled.header`+ display: grid;+ margin-bottom: ${theme.spacing(10)};+ row-gap: ${theme.spacing(4)};+`;++const Meta = styled.p`+ color: ${theme.colors.primary.text[60]};+ font-family: ${theme.font.family.mono};+ font-size: ${theme.font.size(3)};+ letter-spacing: 0.04em;+ margin: 0;+ text-transform: uppercase;+`;++const Title = styled.h1`+ color: ${theme.colors.primary.text[100]};+ font-family: ${theme.font.family.serif};+ font-size: ${theme.font.size(10)};+ font-weight: ${theme.font.weight.light};+ line-height: ${theme.lineHeight(11.5)};+ margin: 0;++ @media (min-width: ${theme.breakpoints.md}px) {+ font-size: ${theme.font.size(15)};+ line-height: ${theme.lineHeight(16.5)};+ }+`;++const Description = styled.p`+ color: ${theme.colors.primary.text[60]};+ font-family: ${theme.font.family.sans};+ font-size: ${theme.font.size(4.5)};+ line-height: ${theme.lineHeight(6.5)};+ margin: 0;+`;++const Tags = styled.ul`+ display: flex;+ flex-wrap: wrap;+ gap: ${theme.spacing(2)};+ list-style: none;+ margin: 0;+ padding: 0;+`;++const Tag = styled.li`+ border: 1px solid ${theme.colors.primary.border[20]};+ border-radius: 999px;+ color: ${theme.colors.primary.text[60]};+ font-family: ${theme.font.family.mono};+ font-size: ${theme.font.size(2.5)};+ letter-spacing: 0.06em;+ padding: ${theme.spacing(1)} ${theme.spacing(2.5)};+ text-transform: uppercase;+`;++type ArticleProps = {+ post: ArticleData;+};++export function Article({ post }: ArticleProps) {+ return (+ <Root variant="article">+ <ArticleEl>+ <StyledContainer>+ <BackLink href="/articles">← Back to articles</BackLink>+ <Header>+ <Meta>+ {formatArticleDate(post.date)} · {post.readingTimeMinutes} min+ read · {post.author}+ </Meta>+ <Title>{post.title}</Title>+ <Description>{post.description}</Description>+ {post.tags.length > 0 ? (+ <Tags>+ {post.tags.map((tag) => (+ <Tag key={tag}>{tag}</Tag>+ ))}+ </Tags>+ ) : null}+ </Header>+ <MarkdownProse markdown={post.content} />+ </StyledContainer>+ </ArticleEl>+ </Root>+ );+}diff --git a/packages/twenty-website-new/src/sections/Articles/components/ArticleIndex.tsx b/packages/twenty-website-new/src/sections/Articles/components/ArticleIndex.tsxnew file mode 100644index 00000000000..315db89966f--- /dev/null+++ b/packages/twenty-website-new/src/sections/Articles/components/ArticleIndex.tsx@@ -0,0 +1,488 @@+import Link from 'next/link';++import { styled } from '@linaria/react';+import type { CSSProperties } from 'react';++import { ArrowRightIcon, PlusIcon } from '@/icons';+import { formatArticleDate, type Article as ArticleData } from '@/lib/articles';+import { theme } from '@/theme';+import { Container } from '@/design-system/components';++type ArticleCardStyle = CSSProperties & { '--article-card-index': number };++const CORNER_SIZE = 14;+const CORNER_OFFSET = '-7px';++const Section = styled.section`+ background-color: #f4f4f4;+ min-width: 0;+ width: 100%;+`;++const StyledContainer = styled(Container)`+ display: flex;+ flex-direction: column;+ gap: ${theme.spacing(10)};+ padding-bottom: ${theme.spacing(36)};+ padding-left: ${theme.spacing(4)};+ padding-right: ${theme.spacing(4)};+ padding-top: ${theme.spacing(20)};++ @media (min-width: ${theme.breakpoints.md}px) {+ gap: ${theme.spacing(14)};+ padding-bottom: ${theme.spacing(44)};+ padding-left: ${theme.spacing(10)};+ padding-right: ${theme.spacing(10)};+ padding-top: ${theme.spacing(24)};+ }+`;++const FramedGrid = styled.div`+ position: relative;++ @media (min-width: ${theme.breakpoints.md}px) {+ padding-bottom: ${theme.spacing(12)};+ padding-left: ${theme.spacing(12)};+ padding-right: ${theme.spacing(12)};+ }++ @media (min-width: ${theme.breakpoints.lg}px) {+ padding-bottom: ${theme.spacing(20)};+ padding-left: ${theme.spacing(20)};+ padding-right: ${theme.spacing(20)};+ }+`;++const FrameRail = styled.span`+ background-color: ${theme.colors.primary.border[10]};+ bottom: 0;+ display: none;+ position: absolute;+ top: ${`calc(6px - ${theme.spacing(24)})`};+ width: 1px;++ @media (min-width: ${theme.breakpoints.md}px) {+ display: block;+ }+`;++const FrameRailLeft = styled(FrameRail)`+ left: 0;+`;++const FrameRailRight = styled(FrameRail)`+ right: 0;+`;++const FrameRailBottom = styled.span`+ background-color: ${theme.colors.primary.border[10]};+ bottom: 0;+ display: none;+ height: 1px;+ left: 0;+ position: absolute;+ right: 0;++ @media (min-width: ${theme.breakpoints.md}px) {+ display: block;+ }+`;++const FrameCorner = styled.span`+ align-items: center;+ display: none;+ height: ${CORNER_SIZE}px;+ justify-content: center;+ line-height: 0;+ pointer-events: none;+ position: absolute;+ width: ${CORNER_SIZE}px;++ @media (min-width: ${theme.breakpoints.md}px) {+ display: flex;+ }+`;++const FrameCornerBottomLeft = styled(FrameCorner)`+ bottom: ${CORNER_OFFSET};+ left: ${CORNER_OFFSET};+`;++const FrameCornerBottomRight = styled(FrameCorner)`+ bottom: ${CORNER_OFFSET};+ right: ${CORNER_OFFSET};+`;++const CardGrid = styled.div`+ display: grid;+ gap: ${theme.spacing(8)};+ grid-template-columns: 1fr;++ @media (min-width: ${theme.breakpoints.md}px) {+ gap: ${theme.spacing(10)};+ grid-template-columns: repeat(2, 1fr);+ }+`;++const CardLink = styled(Link)<{ $isLarge: boolean }>`+ @keyframes articleCardEnter {+ from {+ opacity: 0;+ transform: translate3d(0, 18px, 0);+ }+ to {+ opacity: 1;+ transform: translate3d(0, 0, 0);+ }+ }++ animation: articleCardEnter 700ms cubic-bezier(0.22, 1, 0.36, 1) both;+ animation-delay: calc(var(--article-card-index) * 90ms + 180ms);+ background-color: ${theme.colors.primary.background[100]};+ border: 1px solid ${theme.colors.primary.border[10]};+ border-radius: ${theme.radius(2)};+ color: inherit;+ display: flex;+ flex-direction: column;+ grid-column: ${({ $isLarge }) => ($isLarge ? '1 / -1' : 'auto')};+ overflow: hidden;+ text-decoration: none;+ transition:+ border-color 0.25s ease,+ box-shadow 0.25s ease,+ transform 0.25s ease;+ will-change: transform;++ @media (min-width: ${theme.breakpoints.md}px) {+ flex-direction: ${({ $isLarge }) => ($isLarge ? 'row' : 'column')};+ }++ &:hover {+ border-color: ${theme.colors.primary.border[20]};+ box-shadow: 0 12px 32px -16px rgba(0, 0, 0, 0.18);+ transform: translateY(-2px);+ }++ @media (prefers-reduced-motion: reduce) {+ animation: none;+ &:hover {+ transform: none;+ }+ }+`;++const Thumbnail = styled.div<{ $isLarge: boolean }>`+ background: linear-gradient(135deg, #f4f2ec 0%, #e8e3d8 100%);+ flex-shrink: 0;+ height: 200px;+ overflow: hidden;+ position: relative;+ width: 100%;++ @media (min-width: ${theme.breakpoints.md}px) {+ height: ${({ $isLarge }) => ($isLarge ? 'auto' : '240px')};+ min-height: ${({ $isLarge }) => ($isLarge ? '360px' : '0')};+ width: ${({ $isLarge }) => ($isLarge ? '50%' : '100%')};+ }+`;++const ThumbnailBadge = styled.span`+ bottom: ${theme.spacing(4)};+ color: ${theme.colors.primary.text[60]};+ font-family: ${theme.font.family.mono};+ font-size: ${theme.font.size(3)};+ font-weight: ${theme.font.weight.medium};+ left: ${theme.spacing(6)};+ letter-spacing: 0.08em;+ position: absolute;+ text-transform: uppercase;+ z-index: 2;++ @media (min-width: ${theme.breakpoints.md}px) {+ bottom: ${theme.spacing(6)};+ left: ${theme.spacing(8)};+ }+`;++const ContentWrapper = styled.div<{ $isLarge: boolean }>`+ display: flex;+ flex: 1;+ flex-direction: column;+ min-width: 0;++ @media (min-width: ${theme.breakpoints.md}px) {+ padding: ${({ $isLarge }) =>+ $isLarge+ ? `${theme.spacing(10)} ${theme.spacing(6)} ${theme.spacing(5)}`+ : '0'};+ }+`;++const CardBody = styled.div<{ $isLarge: boolean }>`+ display: flex;+ flex: 1;+ flex-direction: column;+ gap: ${theme.spacing(3)};+ padding: ${theme.spacing(5)} ${theme.spacing(6)};++ @media (min-width: ${theme.breakpoints.md}px) {+ gap: ${({ $isLarge }) => ($isLarge ? theme.spacing(5) : theme.spacing(3))};+ padding: ${({ $isLarge }) =>+ $isLarge ? '0' : `${theme.spacing(5)} ${theme.spacing(6)}`};+ }+`;++const DateLabel = styled.span`+ color: ${theme.colors.primary.text[60]};+ font-family: ${theme.font.family.mono};+ font-size: ${theme.font.size(3)};+ font-weight: ${theme.font.weight.medium};+ letter-spacing: 0.08em;+ text-transform: uppercase;+`;++const Title = styled.h2<{ $isLarge: boolean }>`+ color: ${theme.colors.primary.text[100]};+ font-family: ${theme.font.family.serif};+ font-size: ${theme.font.size(6)};+ font-weight: ${theme.font.weight.light};+ line-height: ${theme.lineHeight(7.5)};+ margin: 0;++ @media (min-width: ${theme.breakpoints.md}px) {+ font-size: ${({ $isLarge }) =>+ $isLarge ? theme.font.size(8) : theme.font.size(6.5)};+ line-height: ${({ $isLarge }) =>+ $isLarge ? theme.lineHeight(9.5) : theme.lineHeight(8)};+ }+`;++const Description = styled.p`+ -webkit-box-orient: vertical;+ -webkit-line-clamp: 2;+ color: ${theme.colors.primary.text[60]};+ display: -webkit-box;+ font-family: ${theme.font.family.sans};+ font-size: ${theme.font.size(4)};+ font-weight: ${theme.font.weight.regular};+ line-height: ${theme.lineHeight(5.5)};+ margin: 0;+ overflow: hidden;+`;++const TagRow = styled.div`+ display: flex;+ flex-wrap: wrap;+ gap: ${theme.spacing(2)};+ padding-bottom: ${theme.spacing(4)};+ padding-left: ${theme.spacing(6)};+ padding-right: ${theme.spacing(6)};++ @media (min-width: ${theme.breakpoints.md}px) {+ padding-bottom: ${theme.spacing(5)};+ }+`;++const Tag = styled.span`+ align-items: center;+ background-color: ${theme.colors.primary.text[5]};+ border: 1px solid ${theme.colors.primary.border[10]};+ border-radius: 999px;+ color: ${theme.colors.primary.text[60]};+ display: inline-flex;+ font-family: ${theme.font.family.mono};+ font-size: ${theme.font.size(2.5)};+ font-weight: ${theme.font.weight.medium};+ letter-spacing: 0.08em;+ padding: ${theme.spacing(1.5)} ${theme.spacing(3.5)};+ text-transform: uppercase;+ white-space: nowrap;+`;++const CardFooter = styled.div<{ $isLarge: boolean }>`+ align-items: center;+ border-top: 1px solid ${theme.colors.primary.border[10]};+ display: flex;+ gap: ${theme.spacing(3)};+ justify-content: space-between;+ margin-left: ${theme.spacing(6)};+ margin-right: ${theme.spacing(6)};+ padding-bottom: ${theme.spacing(5)};+ padding-top: ${theme.spacing(5)};++ @media (min-width: ${theme.breakpoints.md}px) {+ margin-left: ${({ $isLarge }) => ($isLarge ? '0' : theme.spacing(6))};+ margin-right: ${({ $isLarge }) => ($isLarge ? '0' : theme.spacing(6))};+ padding-top: ${({ $isLarge }) =>+ $isLarge ? theme.spacing(6) : theme.spacing(5)};+ }+`;++const AuthorGroup = styled.div`+ align-items: center;+ display: flex;+ flex: 1;+ gap: ${theme.spacing(3)};+ min-width: 0;+`;++const AuthorAvatar = styled.div`+ align-items: center;+ background-color: ${theme.colors.highlight[100]};+ border-radius: 50%;+ color: ${theme.colors.secondary.text[100]};+ display: flex;+ flex-shrink: 0;+ font-family: ${theme.font.family.sans};+ font-size: ${theme.font.size(3)};+ font-weight: ${theme.font.weight.medium};+ height: 32px;+ justify-content: center;+ width: 32px;+`;++const AuthorText = styled.div`+ color: ${theme.colors.primary.text[80]};+ font-family: ${theme.font.family.sans};+ font-size: ${theme.font.size(3.5)};+ min-width: 0;+ overflow: hidden;+ text-overflow: ellipsis;+ white-space: nowrap;+`;++const ReadIconButton = styled.span`+ align-items: center;+ border: 1px solid ${theme.colors.primary.border[20]};+ border-radius: ${theme.radius(2)};+ color: ${theme.colors.primary.text[80]};+ display: inline-flex;+ flex-shrink: 0;+ height: 40px;+ justify-content: center;+ transition: transform 0.2s cubic-bezier(0.2, 0.8, 0.2, 1);+ width: 40px;++ a:hover & {+ transform: scale(1.08);+ }+`;++const EmptyState = styled.div`+ background: ${theme.colors.primary.background[100]};+ border: 1px solid ${theme.colors.primary.border[10]};+ border-radius: ${theme.radius(2)};+ max-width: 720px;+ padding: ${theme.spacing(6)};+`;++const EmptyStateTitle = styled.p`+ color: ${theme.colors.primary.text[80]};+ font-family: ${theme.font.family.sans};+ font-size: ${theme.font.size(4.5)};+ font-weight: ${theme.font.weight.medium};+ margin: 0;+`;++type ArticleCardProps = {+ index: number;+ isLarge: boolean;+ post: ArticleData;+};++function ArticleCard({ index, isLarge, post }: ArticleCardProps) {+ const initials = post.author+ .split(' ')+ .map((word) => word[0])+ .join('')+ .slice(0, 2);+ const cardStyle: ArticleCardStyle = { '--article-card-index': index };++ return (+ <CardLink+ $isLarge={isLarge}+ href={`/articles/${post.slug}`}+ style={cardStyle}+ >+ <Thumbnail $isLarge={isLarge}>+ <ThumbnailBadge>+ Article · {post.readingTimeMinutes} min read+ </ThumbnailBadge>+ </Thumbnail>++ <ContentWrapper $isLarge={isLarge}>+ <CardBody $isLarge={isLarge}>+ <DateLabel>{formatArticleDate(post.date)}</DateLabel>+ <Title $isLarge={isLarge}>{post.title}</Title>+ <Description>{post.description}</Description>+ </CardBody>++ {post.tags.length > 0 ? (+ <TagRow>+ {post.tags.map((tag) => (+ <Tag key={tag}>{tag}</Tag>+ ))}+ </TagRow>+ ) : null}++ <CardFooter $isLarge={isLarge}>+ <AuthorGroup>+ <AuthorAvatar>{initials}</AuthorAvatar>+ <AuthorText>{post.author}</AuthorText>+ </AuthorGroup>+ <ReadIconButton aria-hidden>+ <ArrowRightIcon size={14} strokeColor="currentColor" />+ </ReadIconButton>+ </CardFooter>+ </ContentWrapper>+ </CardLink>+ );+}++type ArticleIndexProps = {+ posts: readonly ArticleData[];+};++export function ArticleIndex({ posts }: ArticleIndexProps) {+ const lastIndex = posts.length - 1;++ return (+ <Section>+ <StyledContainer>+ <FramedGrid>+ <FrameRailLeft aria-hidden />+ <FrameRailRight aria-hidden />+ <FrameRailBottom aria-hidden />+ <FrameCornerBottomLeft aria-hidden>+ <PlusIcon+ size={CORNER_SIZE}+ strokeColor={theme.colors.highlight[100]}+ />+ </FrameCornerBottomLeft>+ <FrameCornerBottomRight aria-hidden>+ <PlusIcon+ size={CORNER_SIZE}+ strokeColor={theme.colors.highlight[100]}+ />+ </FrameCornerBottomRight>+ {posts.length === 0 ? (+ <EmptyState>+ <EmptyStateTitle>No posts published yet.</EmptyStateTitle>+ </EmptyState>+ ) : (+ <CardGrid>+ {posts.map((post, index) => (+ <ArticleCard+ index={index}+ isLarge={index === 0 || index === lastIndex}+ key={post.slug}+ post={post}+ />+ ))}+ </CardGrid>+ )}+ </FramedGrid>+ </StyledContainer>+ </Section>+ );+}diff --git a/packages/twenty-website-new/src/sections/Articles/components/Root.tsx b/packages/twenty-website-new/src/sections/Articles/components/Root.tsxnew file mode 100644index 00000000000..275e270b609--- /dev/null+++ b/packages/twenty-website-new/src/sections/Articles/components/Root.tsx@@ -0,0 +1,33 @@+import type { ReactNode } from 'react';++import { styled } from '@linaria/react';++import { theme } from '@/theme';++type RootVariant = 'article' | 'index';++type RootProps = {+ children: ReactNode;+ variant?: RootVariant;+};++const RootSection = styled.section`+ color: ${theme.colors.primary.text[100]};++ &[data-variant='index'] {+ background: radial-gradient(+ circle at 14% 8%,+ rgba(255, 255, 255, 0.76),+ transparent 30%+ ),+ linear-gradient(180deg, #f4f2ec 0%, #ffffff 44%, #f3f3f3 100%);+ }++ &[data-variant='article'] {+ background: linear-gradient(180deg, #f4f2ec 0%, #ffffff 360px);+ }+`;++export function Root({ children, variant = 'index' }: RootProps) {+ return <RootSection data-variant={variant}>{children}</RootSection>;+}diff --git a/packages/twenty-website-new/src/sections/Articles/components/index.ts b/packages/twenty-website-new/src/sections/Articles/components/index.tsnew file mode 100644index 00000000000..1b263f8ecab--- /dev/null+++ b/packages/twenty-website-new/src/sections/Articles/components/index.ts@@ -0,0 +1,7 @@+import { Article } from './Article';+import { ArticleIndex } from './ArticleIndex';++export const Articles = {+ Article,+ Index: ArticleIndex,+};diff --git a/packages/twenty-website-new/src/sections/Footer/data.ts b/packages/twenty-website-new/src/sections/Footer/data.tsindex d0a998cdbf5..4532d2b48cb 100644--- a/packages/twenty-website-new/src/sections/Footer/data.ts+++ b/packages/twenty-website-new/src/sections/Footer/data.ts@@ -15,6 +15,7 @@ export const FOOTER_DATA: FooterDataType = {{ label: msg`Pricing`, href: '/pricing', external: false },{ label: msg`Partners`, href: '/partners', external: false },{ label: msg`Why Twenty`, href: '/why-twenty', external: false },+ { label: msg`Articles`, href: '/articles', external: false },],},{diff --git a/packages/twenty-website-new/src/sections/Hero/components/Body.tsx b/packages/twenty-website-new/src/sections/Hero/components/Body.tsxindex 60baa5aef87..2294d1eed42 100644--- a/packages/twenty-website-new/src/sections/Hero/components/Body.tsx+++ b/packages/twenty-website-new/src/sections/Hero/components/Body.tsx@@ -56,6 +56,10 @@ const StyledBody = styled.div`white-space: pre-line;}+ &[data-page='articles'] {+ max-width: 550px;+ }+&[data-page='caseStudies'] {max-width: 550px;}diff --git a/packages/twenty-website-new/src/sections/Menu/data.ts b/packages/twenty-website-new/src/sections/Menu/data.tsindex 276efa84c83..f42764e1847 100644--- a/packages/twenty-website-new/src/sections/Menu/data.ts+++ b/packages/twenty-website-new/src/sections/Menu/data.ts@@ -1,4 +1,5 @@import { msg } from '@lingui/core/macro';+import { getPublishedArticles } from '@/lib/articles';import { getLatestReleasePreview } from '@/lib/releases/get-latest-release-preview';import type {MenuDataType,@@ -15,6 +16,8 @@ const FALLBACK_RELEASES_PREVIEW: MenuNavChildPreview = {description: msg`Track every release with changelogs, highlights and demos of the newest features.`,};+const HAS_PUBLISHED_ARTICLES = getPublishedArticles().length > 0;+function buildNavItems(): MenuNavItemType[] {const releasesPreview =getLatestReleasePreview() ?? FALLBACK_RELEASES_PREVIEW;@@ -72,6 +75,16 @@ function buildNavItems(): MenuNavItemType[] {icon: 'tag',preview: releasesPreview,},+ ...(HAS_PUBLISHED_ARTICLES+ ? [+ {+ label: msg`Articles`,+ description: msg`Read Twenty insights`,+ href: '/articles',+ icon: 'book' as const,+ },+ ]+ : []),],},{ label: msg`Customers`, href: '/customers' },diff --git a/packages/twenty-website-new/src/sections/ReleaseNotes/components/ReleaseMarkdown.tsx b/packages/twenty-website-new/src/sections/ReleaseNotes/components/ReleaseMarkdown.tsxindex 2284840f374..2edd12f000f 100644--- a/packages/twenty-website-new/src/sections/ReleaseNotes/components/ReleaseMarkdown.tsx+++ b/packages/twenty-website-new/src/sections/ReleaseNotes/components/ReleaseMarkdown.tsx@@ -1,165 +1,9 @@-'use client';--import { theme } from '@/theme';-import { styled } from '@linaria/react';-import ReactMarkdown from 'react-markdown';-import remarkGfm from 'remark-gfm';--function resolveAssetUrl(url: string | undefined): string {- if (!url) {- return '';- }- if (url.startsWith('/')) {- return url;- }- return url;-}--const Prose = styled.div`- max-width: 100%;- min-width: 0;-- h1 {- color: ${theme.colors.primary.text[100]};- font-size: ${theme.font.size(8)};- font-weight: ${theme.font.weight.medium};- line-height: 1.25;- margin: 0;- margin-top: ${theme.spacing(8)};-- &:first-child {- margin-top: 0;- }- }-- h2 {- color: ${theme.colors.primary.text[100]};- font-size: ${theme.font.size(6)};- font-weight: ${theme.font.weight.medium};- line-height: 1.3;- margin: 0;- margin-top: ${theme.spacing(8)};-- &:first-child {- margin-top: 0;- }- }-- h3 {- color: ${theme.colors.primary.text[100]};- font-size: ${theme.font.size(5)};- font-weight: ${theme.font.weight.medium};- line-height: 1.35;- margin: 0;- margin-top: ${theme.spacing(6)};- }-- p {- color: ${theme.colors.primary.text[80]};- font-size: ${theme.font.size(4)};- line-height: 1.65;- margin: 0;- margin-top: ${theme.spacing(4)};- }-- ul,- ol {- color: ${theme.colors.primary.text[80]};- font-size: ${theme.font.size(4)};- line-height: 1.65;- margin: ${theme.spacing(4)} 0 0;- padding-left: ${theme.spacing(6)};- }-- li {- margin-top: ${theme.spacing(2)};- }-- a {- color: ${theme.colors.highlight[100]};- text-decoration: underline;- text-underline-offset: 2px;- }-- code {- background-color: ${theme.colors.primary.border[10]};- border-radius: ${theme.radius(1)};- font-family: ${theme.font.family.mono};- font-size: 0.9em;- padding: 0.1em 0.35em;- }-- pre {- background-color: ${theme.colors.primary.border[10]};- border-radius: ${theme.radius(2)};- margin-top: ${theme.spacing(4)};- overflow: auto;- padding: ${theme.spacing(4)};- }-- pre code {- background: none;- padding: 0;- }-- img {- border-radius: ${theme.radius(2)};- display: block;- height: auto;- margin-top: ${theme.spacing(6)};- max-width: min(100%, 720px);- width: auto;- }-- hr {- border: none;- border-top: 1px solid ${theme.colors.primary.border[20]};- margin: ${theme.spacing(8)} 0 0;- }-- blockquote {- border-left: 2px solid ${theme.colors.primary.border[40]};- color: ${theme.colors.primary.text[60]};- margin: ${theme.spacing(4)} 0 0;- padding-left: ${theme.spacing(4)};- }-`;+import { MarkdownProse } from '@/design-system/components/MarkdownProse';type ReleaseMarkdownProps = {markdown: string;};export function ReleaseMarkdown({ markdown }: ReleaseMarkdownProps) {- return (- <Prose>- <ReactMarkdown- components={{- a: ({ children, href, ...props }) => (- <a- href={resolveAssetUrl(href)}- rel="noopener noreferrer"- // oxlint-disable-next-line react/jsx-props-no-spreading -- ReactMarkdown component overrides- {...props}- >- {children}- </a>- ),- img: ({ alt, src, ...props }) => (- <img- alt={alt ?? ''}- decoding="async"- loading="lazy"- src={resolveAssetUrl(src)}- // oxlint-disable-next-line react/jsx-props-no-spreading -- ReactMarkdown component overrides- {...props}- />- ),- }}- remarkPlugins={[remarkGfm]}- urlTransform={(value) => value}- >- {markdown}- </ReactMarkdown>- </Prose>- );+ return <MarkdownProse markdown={markdown} />;}