Skip to content

The open alternative to Salesforce, designed for AI.

feat(website): add public apps marketplace with one-click install (#22611)

martmull16e5d2b9d080
diff --git a/packages/twenty-website/.env.example b/packages/twenty-website/.env.example
index b3ac1c405d6..0fc49c511cf 100644
--- a/packages/twenty-website/.env.example
+++ b/packages/twenty-website/.env.example
@@ -13,6 +13,11 @@ PARTNER_APPLICATION_SECRET=
TWENTY_PARTNERS_API_URL=
TWENTY_PARTNERS_API_KEY=
+# Apps marketplace — the apps directory reads the vetted marketplace catalog
+# from the Twenty GraphQL API (public publicMarketplaceApps query), server-side.
+# Defaults to https://api.twenty.com when unset.
+TWENTY_MARKETPLACE_API_URL=
+
# Stripe — self-hosted enterprise checkout & subscription APIs.
STRIPE_SECRET_KEY=
STRIPE_ENTERPRISE_MONTHLY_PRICE_ID=
diff --git a/packages/twenty-website/src/app/[locale]/(site)/apps/[slug]/page.tsx b/packages/twenty-website/src/app/[locale]/(site)/apps/[slug]/page.tsx
new file mode 100644
index 00000000000..d337a2a7b50
--- /dev/null
+++ b/packages/twenty-website/src/app/[locale]/(site)/apps/[slug]/page.tsx
@@ -0,0 +1,72 @@
+import { msg } from '@lingui/core/macro';
+import { type Metadata } from 'next';
+import { notFound } from 'next/navigation';
+
+import { AppDetail, fetchMarketplaceAppDetailBySlug } from '@/apps-marketplace';
+import { getCommunityStats } from '@/platform/community';
+import { getRouteI18n } from '@/platform/i18n/get-route-i18n';
+import { getServerI18n } from '@/platform/i18n/get-server-i18n';
+import { resolveLocaleParam } from '@/platform/i18n/resolve-locale-param';
+import { buildBreadcrumbListJsonLd, JsonLd } from '@/platform/seo';
+import { Menu } from '@/sections/menu';
+
+type AppParams = { locale: string; slug: string };
+
+export const dynamic = 'force-dynamic';
+
+export async function generateMetadata({
+ params,
+}: {
+ params: Promise<AppParams>;
+}): Promise<Metadata> {
+ await getRouteI18n(params);
+ const i18n = getServerI18n();
+ const { slug } = await params;
+ const app = await fetchMarketplaceAppDetailBySlug(slug);
+
+ if (app === null) {
+ return { title: i18n._(msg`App not found — Twenty`) };
+ }
+
+ return {
+ title: i18n._(msg`${app.name} — Twenty Apps`),
+ description: app.tagline,
+ };
+}
+
+export default async function AppDetailPage({
+ params,
+}: {
+ params: Promise<AppParams>;
+}) {
+ const [, communityStats] = await Promise.all([
+ getRouteI18n(params),
+ getCommunityStats(),
+ ]);
+ const { locale: rawLocale, slug } = await params;
+ const locale = resolveLocaleParam(rawLocale);
+ const app = await fetchMarketplaceAppDetailBySlug(slug);
+
+ if (app === null) {
+ notFound();
+ }
+
+ return (
+ <>
+ <JsonLd
+ data={buildBreadcrumbListJsonLd(
+ [
+ { name: 'Home', path: '/' },
+ { name: 'Apps', path: '/apps' },
+ { name: app.name, path: `/apps/${slug}` },
+ ],
+ locale,
+ )}
+ />
+ <Menu communityStats={communityStats} scheme="light" />
+ <main>
+ <AppDetail app={app} />
+ </main>
+ </>
+ );
+}
diff --git a/packages/twenty-website/src/app/[locale]/(site)/apps/page.tsx b/packages/twenty-website/src/app/[locale]/(site)/apps/page.tsx
new file mode 100644
index 00000000000..49452118578
--- /dev/null
+++ b/packages/twenty-website/src/app/[locale]/(site)/apps/page.tsx
@@ -0,0 +1,53 @@
+import {
+ AppsMarketplaceClient,
+ AppsMarketplaceHeader,
+ fetchMarketplaceApps,
+} from '@/apps-marketplace';
+import { getCommunityStats } from '@/platform/community';
+import {
+ getRouteI18n,
+ type LocaleRouteParams,
+} from '@/platform/i18n/get-route-i18n';
+import { resolveLocaleParam } from '@/platform/i18n/resolve-locale-param';
+import {
+ buildBreadcrumbListJsonLd,
+ buildRouteMetadata,
+ JsonLd,
+} from '@/platform/seo';
+import { Menu } from '@/sections/menu';
+
+export const generateMetadata = buildRouteMetadata('apps');
+
+export const dynamic = 'force-dynamic';
+
+export default async function AppsMarketplacePage({
+ params,
+}: {
+ params: Promise<LocaleRouteParams>;
+}) {
+ const [, communityStats, apps] = await Promise.all([
+ getRouteI18n(params),
+ getCommunityStats(),
+ fetchMarketplaceApps(),
+ ]);
+ const locale = resolveLocaleParam((await params).locale);
+
+ return (
+ <>
+ <JsonLd
+ data={buildBreadcrumbListJsonLd(
+ [
+ { name: 'Home', path: '/' },
+ { name: 'Apps', path: '/apps' },
+ ],
+ locale,
+ )}
+ />
+ <Menu communityStats={communityStats} scheme="light" />
+ <main>
+ <AppsMarketplaceHeader />
+ <AppsMarketplaceClient apps={apps} />
+ </main>
+ </>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppCard.tsx b/packages/twenty-website/src/apps-marketplace/AppCard.tsx
new file mode 100644
index 00000000000..824ef31ed5f
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppCard.tsx
@@ -0,0 +1,207 @@
+'use client';
+
+import { msg } from '@lingui/core/macro';
+import { useLingui } from '@lingui/react';
+import { styled } from '@linaria/react';
+import { type CSSProperties } from 'react';
+
+import { LocalizedLink } from '@/platform/i18n/LocalizedLink';
+import {
+ color,
+ EASING,
+ FONT_WEIGHT,
+ fontFamily,
+ fontSize,
+ radius,
+ REDUCED_MOTION,
+ semanticColor,
+ SHADOW,
+ spacing,
+} from '@/tokens';
+import { Button } from '@/ui';
+
+import { AppLogo } from './AppLogo';
+import { buildAppInstallUrl } from './build-app-install-url';
+import { type MarketplaceApp } from './marketplace-app';
+
+type AppCardStyle = CSSProperties & {
+ '--app-card-index': number;
+};
+
+const CardArticle = styled.article`
+ @keyframes appCardEnter {
+ from {
+ opacity: 0;
+ transform: translate3d(0, 18px, 0);
+ }
+ to {
+ opacity: 1;
+ transform: translate3d(0, 0, 0);
+ }
+ }
+
+ animation: appCardEnter 700ms ${EASING.standard} both;
+ animation-delay: calc(var(--app-card-index) * 90ms + 180ms);
+ background-color: ${color('white')};
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(2)};
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(5)};
+ isolation: isolate;
+ padding: ${spacing(6)};
+ position: relative;
+ transition:
+ border-color 0.25s ease,
+ box-shadow 0.25s ease,
+ transform 0.25s ease;
+ will-change: transform;
+
+ &:hover {
+ border-color: ${semanticColor.lineStrong};
+ box-shadow: ${SHADOW.card};
+ transform: translateY(-2px);
+ }
+
+ ${REDUCED_MOTION} {
+ animation: none;
+ transition: none;
+
+ &:hover {
+ transform: none;
+ }
+ }
+`;
+
+const CardHeader = styled.div`
+ align-items: center;
+ display: flex;
+ gap: ${spacing(4)};
+`;
+
+const HeaderText = styled.div`
+ display: flex;
+ flex-direction: column;
+ min-width: 0;
+
+ & > * + * {
+ margin-top: ${spacing(1)};
+ }
+`;
+
+const AppName = styled.h3`
+ color: ${semanticColor.ink};
+ font-family: ${fontFamily('serif')};
+ font-size: ${fontSize(6)};
+ font-weight: ${FONT_WEIGHT.light};
+ letter-spacing: -0.02em;
+ line-height: ${fontSize(7)};
+`;
+
+const NameLink = styled(LocalizedLink)`
+ color: inherit;
+ text-decoration: none;
+
+ &::after {
+ border-radius: ${radius(2)};
+ content: '';
+ inset: 0;
+ position: absolute;
+ z-index: 0;
+ }
+
+ &:focus-visible::after {
+ outline: 2px solid ${semanticColor.ink};
+ outline-offset: 4px;
+ }
+`;
+
+const CategoryEyebrow = styled.span`
+ color: ${semanticColor.inkMuted};
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(3)};
+ font-weight: ${FONT_WEIGHT.medium};
+ letter-spacing: 0.08em;
+ line-height: ${fontSize(4)};
+ text-transform: uppercase;
+`;
+
+const Tagline = styled.p`
+ -webkit-box-orient: vertical;
+ -webkit-line-clamp: 3;
+ color: ${semanticColor.inkMuted};
+ display: -webkit-box;
+ font-family: ${fontFamily('sans')};
+ font-size: ${fontSize(4)};
+ line-height: ${fontSize(5.5)};
+ overflow: hidden;
+`;
+
+const CtaRow = styled.div`
+ align-items: center;
+ display: flex;
+ gap: ${spacing(4)};
+ margin-top: auto;
+ position: relative;
+ z-index: 1;
+`;
+
+const LearnMoreLink = styled(LocalizedLink)`
+ color: ${semanticColor.inkMuted};
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(3)};
+ font-weight: ${FONT_WEIGHT.medium};
+ letter-spacing: 0.02em;
+ text-decoration: none;
+ text-transform: uppercase;
+ transition: color 0.2s ease;
+
+ &:hover {
+ color: ${semanticColor.ink};
+ }
+`;
+
+type AppCardProps = {
+ app: MarketplaceApp;
+ index: number;
+};
+
+export function AppCard({ app, index }: AppCardProps) {
+ const { i18n } = useLingui();
+ const headingId = `app-card-heading-${app.slug}`;
+ const style: AppCardStyle = { '--app-card-index': index };
+ const detailHref = `/apps/${app.slug}`;
+
+ return (
+ <CardArticle aria-labelledby={headingId} style={style}>
+ <CardHeader>
+ <AppLogo name={app.name} logoUrl={app.logoUrl} />
+ <HeaderText>
+ <AppName id={headingId}>
+ <NameLink href={detailHref}>{app.name}</NameLink>
+ </AppName>
+ {app.category.length > 0 && (
+ <CategoryEyebrow>{app.category}</CategoryEyebrow>
+ )}
+ </HeaderText>
+ </CardHeader>
+
+ <Tagline>{app.tagline}</Tagline>
+
+ <CtaRow>
+ <Button
+ href={buildAppInstallUrl(app.universalIdentifier)}
+ label={i18n._(msg`Install`)}
+ variant="filled"
+ size="small"
+ />
+ <LearnMoreLink
+ href={detailHref}
+ aria-label={i18n._(msg`Learn more about ${app.name}`)}
+ >
+ {i18n._(msg`Learn more`)}
+ </LearnMoreLink>
+ </CtaRow>
+ </CardArticle>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppDetail.tsx b/packages/twenty-website/src/apps-marketplace/AppDetail.tsx
new file mode 100644
index 00000000000..507ad658f17
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppDetail.tsx
@@ -0,0 +1,245 @@
+import { msg } from '@lingui/core/macro';
+import { styled } from '@linaria/react';
+
+import { getServerI18n } from '@/platform/i18n/get-server-i18n';
+import {
+ FONT_WEIGHT,
+ fontFamily,
+ fontSize,
+ mediaUp,
+ radius,
+ semanticColor,
+ spacing,
+} from '@/tokens';
+import { Body, Button, ExternalLink, Heading, SectionShell } from '@/ui';
+
+import { AppLogo } from './AppLogo';
+import { buildAppInstallUrl } from './build-app-install-url';
+import { type MarketplaceAppDetail } from './marketplace-app';
+
+const HeroRow = styled.div`
+ align-items: flex-start;
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(6)};
+
+ ${mediaUp('md')} {
+ align-items: center;
+ flex-direction: row;
+ gap: ${spacing(8)};
+ }
+`;
+
+const HeroText = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(3)};
+ min-width: 0;
+`;
+
+const CategoryEyebrow = styled.span`
+ color: ${semanticColor.inkMuted};
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(3)};
+ font-weight: ${FONT_WEIGHT.medium};
+ letter-spacing: 0.08em;
+ line-height: ${fontSize(4)};
+ text-transform: uppercase;
+`;
+
+const HeroActions = styled.div`
+ align-items: center;
+ display: flex;
+ flex-wrap: wrap;
+ gap: ${spacing(4)};
+ margin-top: ${spacing(2)};
+`;
+
+const VettedBadge = styled.span`
+ align-items: center;
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(4)};
+ color: ${semanticColor.inkMuted};
+ display: inline-flex;
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(2)};
+ font-weight: ${FONT_WEIGHT.medium};
+ gap: ${spacing(2)};
+ letter-spacing: 0.06em;
+ padding: ${spacing(1)} ${spacing(3)};
+ text-transform: uppercase;
+`;
+
+const ContentGrid = styled.div`
+ display: grid;
+ gap: ${spacing(8)};
+ grid-template-columns: 1fr;
+
+ ${mediaUp('lg')} {
+ grid-template-columns: minmax(0, 2fr) minmax(0, 1fr);
+ }
+`;
+
+const MainColumn = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(6)};
+ min-width: 0;
+`;
+
+const ScreenshotList = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(5)};
+`;
+
+const Screenshot = styled.img`
+ aspect-ratio: 16 / 10;
+ background-color: ${semanticColor.surface};
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(2)};
+ display: block;
+ height: auto;
+ object-fit: cover;
+ width: 100%;
+`;
+
+const Sidebar = styled.aside`
+ align-self: flex-start;
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(2)};
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(4)};
+ padding: ${spacing(6)};
+`;
+
+const DetailRow = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${spacing(1)};
+`;
+
+const DetailLabel = styled.span`
+ color: ${semanticColor.inkMuted};
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(2)};
+ font-weight: ${FONT_WEIGHT.medium};
+ letter-spacing: 0.06em;
+ text-transform: uppercase;
+`;
+
+const DetailValue = styled.span`
+ color: ${semanticColor.ink};
+ font-family: ${fontFamily('sans')};
+ font-size: ${fontSize(4)};
+ word-break: break-word;
+`;
+
+const DetailLink = styled(ExternalLink)`
+ color: ${semanticColor.ink};
+ font-family: ${fontFamily('sans')};
+ font-size: ${fontSize(4)};
+ text-decoration: underline;
+ word-break: break-word;
+`;
+
+const Divider = styled.hr`
+ background-color: ${semanticColor.line};
+ border: 0;
+ height: 1px;
+ width: 100%;
+`;
+
+type AppDetailProps = {
+ app: MarketplaceAppDetail;
+};
+
+export function AppDetail({ app }: AppDetailProps) {
+ const i18n = getServerI18n();
+ const installUrl = buildAppInstallUrl(app.universalIdentifier);
+
+ return (
+ <>
+ <SectionShell rhythm="hero" scheme="light">
+ <HeroRow>
+ <AppLogo
+ name={app.name}
+ logoUrl={app.logoUrl}
+ size={96}
+ loading="eager"
+ />
+ <HeroText>
+ {app.category.length > 0 && (
+ <CategoryEyebrow>{app.category}</CategoryEyebrow>
+ )}
+ <Heading as="h1" size="lg" weight="light">
+ {app.name}
+ </Heading>
+ <Body muted size="md">
+ {app.tagline}
+ </Body>
+ <HeroActions>
+ <Button
+ href={installUrl}
+ label={i18n._(msg`Install`)}
+ variant="filled"
+ />
+ <VettedBadge>{i18n._(msg`Vetted by Twenty`)}</VettedBadge>
+ </HeroActions>
+ </HeroText>
+ </HeroRow>
+ </SectionShell>
+
+ <SectionShell rhythm="section" scheme="light">
+ <ContentGrid>
+ <MainColumn>
+ {app.screenshots.length > 0 && (
+ <ScreenshotList>
+ {app.screenshots.map((screenshot) => (
+ <Screenshot
+ key={screenshot}
+ src={screenshot}
+ alt={i18n._(msg`${app.name} screenshot`)}
+ loading="lazy"
+ />
+ ))}
+ </ScreenshotList>
+ )}
+ </MainColumn>
+
+ <Sidebar>
+ <Button
+ href={installUrl}
+ label={i18n._(msg`Install on Twenty`)}
+ variant="filled"
+ />
+ <Divider aria-hidden="true" />
+ <DetailRow>
+ <DetailLabel>{i18n._(msg`Developer`)}</DetailLabel>
+ <DetailValue>{app.author}</DetailValue>
+ </DetailRow>
+ {app.category.length > 0 && (
+ <DetailRow>
+ <DetailLabel>{i18n._(msg`Category`)}</DetailLabel>
+ <DetailValue>{app.category}</DetailValue>
+ </DetailRow>
+ )}
+ {app.sourcePackage !== undefined && (
+ <DetailRow>
+ <DetailLabel>{i18n._(msg`Package`)}</DetailLabel>
+ <DetailValue>{app.sourcePackage}</DetailValue>
+ </DetailRow>
+ )}
+ {app.websiteUrl !== undefined && (
+ <DetailRow>
+ <DetailLabel>{i18n._(msg`Website`)}</DetailLabel>
+ <DetailLink href={app.websiteUrl}>{app.websiteUrl}</DetailLink>
+ </DetailRow>
+ )}
+ </Sidebar>
+ </ContentGrid>
+ </SectionShell>
+ </>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppLogo.tsx b/packages/twenty-website/src/apps-marketplace/AppLogo.tsx
new file mode 100644
index 00000000000..e6e48386723
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppLogo.tsx
@@ -0,0 +1,69 @@
+import { styled } from '@linaria/react';
+import { type CSSProperties } from 'react';
+
+import {
+ color,
+ FONT_WEIGHT,
+ fontFamily,
+ radius,
+ semanticColor,
+} from '@/tokens';
+
+const LogoBlock = styled.span`
+ align-items: center;
+ background-color: ${color('white')};
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(1.5)};
+ color: ${semanticColor.ink};
+ display: inline-flex;
+ flex-shrink: 0;
+ font-family: ${fontFamily('serif')};
+ font-weight: ${FONT_WEIGHT.light};
+ height: var(--app-logo-size);
+ justify-content: center;
+ overflow: hidden;
+ width: var(--app-logo-size);
+`;
+
+const LogoImage = styled.img`
+ display: block;
+ height: 62%;
+ object-fit: contain;
+ width: 62%;
+`;
+
+type AppLogoStyle = CSSProperties & {
+ '--app-logo-size': string;
+};
+
+type AppLogoProps = {
+ name: string;
+ logoUrl?: string;
+ size?: number;
+ loading?: 'lazy' | 'eager';
+};
+
+const getInitial = (name: string): string =>
+ name.trim().charAt(0).toUpperCase() || '?';
+
+export function AppLogo({
+ name,
+ logoUrl,
+ size = 48,
+ loading = 'lazy',
+}: AppLogoProps) {
+ const style: AppLogoStyle = {
+ '--app-logo-size': `${size}px`,
+ fontSize: `${Math.round(size * 0.42)}px`,
+ };
+
+ return (
+ <LogoBlock style={style}>
+ {logoUrl !== undefined && logoUrl.length > 0 ? (
+ <LogoImage src={logoUrl} alt={`${name} logo`} loading={loading} />
+ ) : (
+ getInitial(name)
+ )}
+ </LogoBlock>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppsGrid.tsx b/packages/twenty-website/src/apps-marketplace/AppsGrid.tsx
new file mode 100644
index 00000000000..bf6534475a7
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppsGrid.tsx
@@ -0,0 +1,35 @@
+import { styled } from '@linaria/react';
+
+import { mediaUp, spacing } from '@/tokens';
+
+import { AppCard } from './AppCard';
+import { type MarketplaceApp } from './marketplace-app';
+
+const CardGrid = styled.div`
+ display: grid;
+ gap: ${spacing(6)};
+ grid-template-columns: 1fr;
+
+ ${mediaUp('md')} {
+ gap: ${spacing(8)};
+ grid-template-columns: repeat(2, 1fr);
+ }
+
+ ${mediaUp('lg')} {
+ grid-template-columns: repeat(3, 1fr);
+ }
+`;
+
+type AppsGridProps = {
+ apps: readonly MarketplaceApp[];
+};
+
+export function AppsGrid({ apps }: AppsGridProps) {
+ return (
+ <CardGrid>
+ {apps.map((app, index) => (
+ <AppCard key={app.slug} app={app} index={index} />
+ ))}
+ </CardGrid>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppsMarketplaceClient.tsx b/packages/twenty-website/src/apps-marketplace/AppsMarketplaceClient.tsx
new file mode 100644
index 00000000000..18aff51a6b9
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppsMarketplaceClient.tsx
@@ -0,0 +1,137 @@
+'use client';
+
+import { msg } from '@lingui/core/macro';
+import { useLingui } from '@lingui/react';
+import { styled } from '@linaria/react';
+import { useMemo, useState } from 'react';
+
+import {
+ color,
+ FONT_WEIGHT,
+ fontFamily,
+ fontSize,
+ radius,
+ semanticColor,
+ spacing,
+} from '@/tokens';
+import { Body, SectionShell } from '@/ui';
+
+import { AppsGrid } from './AppsGrid';
+import { type MarketplaceApp } from './marketplace-app';
+
+const FilterRow = styled.div`
+ display: flex;
+ flex-wrap: wrap;
+ gap: ${spacing(2)};
+ margin-bottom: ${spacing(6)};
+`;
+
+const FilterChip = styled.button`
+ background-color: ${color('white')};
+ border: 1px solid ${semanticColor.line};
+ border-radius: ${radius(4)};
+ color: ${semanticColor.inkMuted};
+ cursor: pointer;
+ font-family: ${fontFamily('mono')};
+ font-size: ${fontSize(3)};
+ font-weight: ${FONT_WEIGHT.medium};
+ letter-spacing: 0.04em;
+ padding: ${spacing(2)} ${spacing(4)};
+ text-transform: uppercase;
+ transition:
+ border-color 0.2s ease,
+ color 0.2s ease,
+ background-color 0.2s ease;
+
+ &:hover {
+ border-color: ${semanticColor.lineStrong};
+ color: ${semanticColor.ink};
+ }
+
+ &[data-active='true'] {
+ background-color: ${color('black')};
+ border-color: ${color('black')};
+ color: ${color('white')};
+ }
+`;
+
+const EmptyState = styled.div`
+ padding-block: ${spacing(10)};
+ text-align: center;
+`;
+
+const ALL_CATEGORIES = 'all';
+
+type AppsMarketplaceClientProps = {
+ apps: readonly MarketplaceApp[];
+};
+
+export function AppsMarketplaceClient({ apps }: AppsMarketplaceClientProps) {
+ const { i18n } = useLingui();
+ const [activeCategory, setActiveCategory] = useState<string>(ALL_CATEGORIES);
+
+ const categories = useMemo(() => {
+ const seen: string[] = [];
+
+ for (const app of apps) {
+ if (app.category.length > 0 && !seen.includes(app.category)) {
+ seen.push(app.category);
+ }
+ }
+
+ return seen.toSorted((a, b) => a.localeCompare(b));
+ }, [apps]);
+
+ const visibleApps = useMemo(() => {
+ const matching =
+ activeCategory === ALL_CATEGORIES
+ ? apps
+ : apps.filter((app) => app.category === activeCategory);
+
+ return matching.toSorted(
+ (a, b) => Number(b.isFeatured) - Number(a.isFeatured),
+ );
+ }, [apps, activeCategory]);
+
+ return (
+ <SectionShell rhythm="section" scheme="light">
+ {apps.length === 0 ? (
+ <EmptyState>
+ <Body muted size="md">
+ {i18n._(msg`No apps are available right now. Check back soon.`)}
+ </Body>
+ </EmptyState>
+ ) : (
+ <>
+ {categories.length > 0 && (
+ <FilterRow
+ role="group"
+ aria-label={i18n._(msg`Filter apps by category`)}
+ >
+ <FilterChip
+ type="button"
+ aria-pressed={activeCategory === ALL_CATEGORIES}
+ data-active={activeCategory === ALL_CATEGORIES}
+ onClick={() => setActiveCategory(ALL_CATEGORIES)}
+ >
+ {i18n._(msg`All`)}
+ </FilterChip>
+ {categories.map((category) => (
+ <FilterChip
+ key={category}
+ type="button"
+ aria-pressed={activeCategory === category}
+ data-active={activeCategory === category}
+ onClick={() => setActiveCategory(category)}
+ >
+ {category}
+ </FilterChip>
+ ))}
+ </FilterRow>
+ )}
+ <AppsGrid apps={visibleApps} />
+ </>
+ )}
+ </SectionShell>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/AppsMarketplaceHeader.tsx b/packages/twenty-website/src/apps-marketplace/AppsMarketplaceHeader.tsx
new file mode 100644
index 00000000000..6524ba75fa3
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/AppsMarketplaceHeader.tsx
@@ -0,0 +1,47 @@
+import { msg } from '@lingui/core/macro';
+import { styled } from '@linaria/react';
+
+import { getServerI18n } from '@/platform/i18n/get-server-i18n';
+import { mediaUp, spacing } from '@/tokens';
+import { Body, Eyebrow, Heading, SectionShell } from '@/ui';
+
+const HeaderStack = styled.div`
+ display: flex;
+ flex-direction: column;
+
+ & > * + * {
+ margin-top: ${spacing(4)};
+ }
+
+ ${mediaUp('md')} {
+ & > * + * {
+ margin-top: ${spacing(6)};
+ }
+ }
+`;
+
+const HeaderBody = styled.div`
+ max-width: 640px;
+`;
+
+export function AppsMarketplaceHeader() {
+ const i18n = getServerI18n();
+
+ return (
+ <SectionShell rhythm="hero" scheme="light">
+ <HeaderStack>
+ <Eyebrow>{i18n._(msg`Marketplace`)}</Eyebrow>
+ <Heading as="h1" size="lg" weight="light">
+ {i18n._(msg`Apps for *Twenty*`)}
+ </Heading>
+ <HeaderBody>
+ <Body muted size="md">
+ {i18n._(
+ msg`Extend your CRM with apps built and maintained by Twenty. Every app here is vetted by our team — install one in a click and it's live in your workspace.`,
+ )}
+ </Body>
+ </HeaderBody>
+ </HeaderStack>
+ </SectionShell>
+ );
+}
diff --git a/packages/twenty-website/src/apps-marketplace/build-app-install-url.ts b/packages/twenty-website/src/apps-marketplace/build-app-install-url.ts
new file mode 100644
index 00000000000..4a0636bfff3
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/build-app-install-url.ts
@@ -0,0 +1,10 @@
+const DEFAULT_TWENTY_APP_BASE_URL = 'https://app.twenty.com';
+
+export const buildAppInstallUrl = (universalIdentifier: string): string => {
+ const baseUrl =
+ process.env.TWENTY_APP_BASE_URL ?? DEFAULT_TWENTY_APP_BASE_URL;
+
+ const returnToPath = `/settings/applications/available/${universalIdentifier}`;
+
+ return `${baseUrl.replace(/\/$/, '')}/?returnToPath=${encodeURIComponent(returnToPath)}`;
+};
diff --git a/packages/twenty-website/src/apps-marketplace/fetch-marketplace-app-detail.ts b/packages/twenty-website/src/apps-marketplace/fetch-marketplace-app-detail.ts
new file mode 100644
index 00000000000..91b3f442b8c
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/fetch-marketplace-app-detail.ts
@@ -0,0 +1,89 @@
+import { fetchMarketplaceApps } from './fetch-marketplace-apps';
+import { getAppSlug } from './get-app-slug';
+import { marketplaceGraphqlRequest } from './marketplace-api-fetch';
+import { type MarketplaceAppDetail } from './marketplace-app';
+
+const FIND_MARKETPLACE_APP_DETAIL_QUERY = `
+ query PublicMarketplaceAppDetail($universalIdentifier: String!) {
+ publicMarketplaceAppDetail(universalIdentifier: $universalIdentifier) {
+ universalIdentifier
+ name
+ sourcePackage
+ latestAvailableVersion
+ isFeatured
+ description
+ author
+ category
+ logo
+ websiteUrl
+ aboutDescription
+ screenshots
+ }
+ }
+`;
+
+type ApiMarketplaceAppDetail = {
+ universalIdentifier: string;
+ name: string;
+ sourcePackage?: string | null;
+ latestAvailableVersion?: string | null;
+ isFeatured: boolean;
+ description?: string | null;
+ author?: string | null;
+ category?: string | null;
+ logo?: string | null;
+ websiteUrl?: string | null;
+ aboutDescription?: string | null;
+ screenshots?: string[] | null;
+};
+
+type FindMarketplaceAppDetailData = {
+ publicMarketplaceAppDetail: ApiMarketplaceAppDetail;
+};
+
+export async function fetchMarketplaceAppDetailBySlug(
+ slug: string,
+): Promise<MarketplaceAppDetail | null> {
+ const apps = await fetchMarketplaceApps();
+ const app = apps.find((candidate) => candidate.slug === slug);
+
+ if (app === undefined) {
+ return null;
+ }
+
+ try {
+ const data = await marketplaceGraphqlRequest<FindMarketplaceAppDetailData>(
+ FIND_MARKETPLACE_APP_DETAIL_QUERY,
+ { universalIdentifier: app.universalIdentifier },
+ );
+
+ const detail = data.publicMarketplaceAppDetail;
+
+ return {
+ universalIdentifier: detail.universalIdentifier,
+ slug: getAppSlug(
+ detail.sourcePackage ?? undefined,
+ detail.universalIdentifier,
+ ),
+ name: detail.name,
+ tagline: app.tagline,
+ author: detail.author ?? app.author,
+ category: detail.category ?? app.category,
+ logoUrl: detail.logo ?? app.logoUrl,
+ sourcePackage: detail.sourcePackage ?? undefined,
+ isFeatured: detail.isFeatured,
+ description: detail.aboutDescription ?? detail.description ?? app.tagline,
+ screenshots: detail.screenshots ?? [],
+ websiteUrl: detail.websiteUrl ?? undefined,
+ latestAvailableVersion: detail.latestAvailableVersion ?? undefined,
+ };
+ } catch (error) {
+ console.error('[apps-marketplace] detail fetch failed:', error);
+
+ return {
+ ...app,
+ description: app.tagline,
+ screenshots: [],
+ };
+ }
+}
diff --git a/packages/twenty-website/src/apps-marketplace/fetch-marketplace-apps.ts b/packages/twenty-website/src/apps-marketplace/fetch-marketplace-apps.ts
new file mode 100644
index 00000000000..e1819d61bb1
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/fetch-marketplace-apps.ts
@@ -0,0 +1,65 @@
+import { getAppSlug } from './get-app-slug';
+import { marketplaceGraphqlRequest } from './marketplace-api-fetch';
+import { type MarketplaceApp } from './marketplace-app';
+
+const FIND_MANY_MARKETPLACE_APPS_QUERY = `
+ query PublicMarketplaceApps {
+ publicMarketplaceApps {
+ id
+ name
+ description
+ author
+ category
+ logo
+ sourcePackage
+ isFeatured
+ }
+ }
+`;
+
+type ApiMarketplaceApp = {
+ id: string;
+ name: string;
+ description: string;
+ author: string;
+ category: string;
+ logo?: string | null;
+ sourcePackage?: string | null;
+ isFeatured: boolean;
+};
+
+type FindManyMarketplaceAppsData = {
+ publicMarketplaceApps: ApiMarketplaceApp[];
+};
+
+const normalizeApp = (apiApp: ApiMarketplaceApp): MarketplaceApp => ({
+ universalIdentifier: apiApp.id,
+ slug: getAppSlug(apiApp.sourcePackage ?? undefined, apiApp.id),
+ name: apiApp.name,
+ tagline: apiApp.description,
+ author: apiApp.author,
+ category: apiApp.category,
+ logoUrl: apiApp.logo ?? undefined,
+ sourcePackage: apiApp.sourcePackage ?? undefined,
+ isFeatured: apiApp.isFeatured,
+});
+
+export async function fetchMarketplaceApps(): Promise<
+ readonly MarketplaceApp[]
+> {
+ try {
+ const data = await marketplaceGraphqlRequest<FindManyMarketplaceAppsData>(
+ FIND_MANY_MARKETPLACE_APPS_QUERY,
+ );
+
+ if (!Array.isArray(data.publicMarketplaceApps)) {
+ throw new Error('marketplace API response missing apps array');
+ }
+
+ return data.publicMarketplaceApps.map(normalizeApp);
+ } catch (error) {
+ console.error('[apps-marketplace] live fetch failed:', error);
+
+ return [];
+ }
+}
diff --git a/packages/twenty-website/src/apps-marketplace/get-app-slug.ts b/packages/twenty-website/src/apps-marketplace/get-app-slug.ts
new file mode 100644
index 00000000000..bfab498d971
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/get-app-slug.ts
@@ -0,0 +1,14 @@
+export const getAppSlug = (
+ sourcePackage: string | undefined,
+ universalIdentifier: string,
+): string => {
+ if (sourcePackage === undefined || sourcePackage.length === 0) {
+ return universalIdentifier;
+ }
+
+ const lastSegment = sourcePackage.split('/').pop();
+
+ return lastSegment !== undefined && lastSegment.length > 0
+ ? lastSegment
+ : universalIdentifier;
+};
diff --git a/packages/twenty-website/src/apps-marketplace/index.ts b/packages/twenty-website/src/apps-marketplace/index.ts
new file mode 100644
index 00000000000..048468843bb
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/index.ts
@@ -0,0 +1,10 @@
+export { AppDetail } from './AppDetail';
+export { AppsMarketplaceClient } from './AppsMarketplaceClient';
+export { AppsMarketplaceHeader } from './AppsMarketplaceHeader';
+export { buildAppInstallUrl } from './build-app-install-url';
+export { fetchMarketplaceApps } from './fetch-marketplace-apps';
+export { fetchMarketplaceAppDetailBySlug } from './fetch-marketplace-app-detail';
+export {
+ type MarketplaceApp,
+ type MarketplaceAppDetail,
+} from './marketplace-app';
diff --git a/packages/twenty-website/src/apps-marketplace/marketplace-api-fetch.ts b/packages/twenty-website/src/apps-marketplace/marketplace-api-fetch.ts
new file mode 100644
index 00000000000..ef9b48bdee6
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/marketplace-api-fetch.ts
@@ -0,0 +1,47 @@
+const REVALIDATE_SECONDS = 300;
+
+const DEFAULT_MARKETPLACE_API_URL = 'https://api.twenty.com';
+
+export async function marketplaceGraphqlRequest<TData>(
+ query: string,
+ variables?: Record<string, unknown>,
+): Promise<TData> {
+ const baseUrl =
+ process.env.TWENTY_MARKETPLACE_API_URL ?? DEFAULT_MARKETPLACE_API_URL;
+
+ const response = await fetch(`${baseUrl.replace(/\/$/, '')}/metadata`, {
+ method: 'POST',
+ headers: {
+ Accept: 'application/json',
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({ query, variables }),
+ next: { revalidate: REVALIDATE_SECONDS },
+ });
+
+ if (!response.ok) {
+ const body = await response.text();
+ throw new Error(
+ `Twenty marketplace API ${response.status}: ${body.slice(0, 300)}`,
+ );
+ }
+
+ const json = (await response.json()) as {
+ data?: TData;
+ errors?: { message: string }[];
+ };
+
+ if (json.errors !== undefined && json.errors.length > 0) {
+ throw new Error(
+ `Twenty marketplace API errors: ${json.errors
+ .map((error) => error.message)
+ .join(', ')}`,
+ );
+ }
+
+ if (json.data === undefined) {
+ throw new Error('Twenty marketplace API returned no data');
+ }
+
+ return json.data;
+}
diff --git a/packages/twenty-website/src/apps-marketplace/marketplace-app.ts b/packages/twenty-website/src/apps-marketplace/marketplace-app.ts
new file mode 100644
index 00000000000..3252a13d4eb
--- /dev/null
+++ b/packages/twenty-website/src/apps-marketplace/marketplace-app.ts
@@ -0,0 +1,18 @@
+export type MarketplaceApp = {
+ universalIdentifier: string;
+ slug: string;
+ name: string;
+ tagline: string;
+ author: string;
+ category: string;
+ logoUrl?: string;
+ sourcePackage?: string;
+ isFeatured: boolean;
+};
+
+export type MarketplaceAppDetail = MarketplaceApp & {
+ description: string;
+ screenshots: readonly string[];
+ websiteUrl?: string;
+ latestAvailableVersion?: string;
+};
diff --git a/packages/twenty-website/src/platform/routing/static-website-routes.ts b/packages/twenty-website/src/platform/routing/static-website-routes.ts
index 1ac8aa2a9e6..3a2f7c9b03b 100644
--- a/packages/twenty-website/src/platform/routing/static-website-routes.ts
+++ b/packages/twenty-website/src/platform/routing/static-website-routes.ts
@@ -12,6 +12,15 @@ export const STATIC_WEBSITE_ROUTES: readonly WebsiteRoute[] = [
priority: 1,
title: msg`Twenty | #1 Open Source CRM`,
},
+ {
+ changeFrequency: 'weekly',
+ description: msg`Extend Twenty with vetted apps — call recording, enrichment, Slack, Discord, Linear and more. Install any app on your open source CRM workspace in one click.`,
+ id: 'apps',
+ indexed: true,
+ path: '/apps',
+ priority: 0.8,
+ title: msg`Twenty Apps — Vetted Apps for the Open Source CRM`,
+ },
{
changeFrequency: 'monthly',
description: msg`Pipelines, custom objects, AI assistants, and a native API on top of Postgres. Twenty is the open source CRM with the modern UX teams actually want to use.`,
diff --git a/packages/twenty-website/src/platform/routing/website-route.ts b/packages/twenty-website/src/platform/routing/website-route.ts
index c7a3a67c1bb..6123c96b77f 100644
--- a/packages/twenty-website/src/platform/routing/website-route.ts
+++ b/packages/twenty-website/src/platform/routing/website-route.ts
@@ -2,6 +2,7 @@ import { type MessageDescriptor } from '@lingui/core';
import { type MetadataRoute } from 'next';
export type WebsiteRouteId =
+ | 'apps'
| 'customers'
| 'enterpriseActivate'
| 'halftone'
diff --git a/packages/twenty-website/src/sections/menu/data/menu.ts b/packages/twenty-website/src/sections/menu/data/menu.ts
index dc750ea1e12..db64f83d521 100644
--- a/packages/twenty-website/src/sections/menu/data/menu.ts
+++ b/packages/twenty-website/src/sections/menu/data/menu.ts
@@ -1,5 +1,6 @@
import { msg } from '@lingui/core/macro';
import {
+ IconApps,
IconBook,
IconBrandLinkedin,
IconBrandX,
@@ -69,6 +70,20 @@ export const MENU: {
description: msg`APIs, SDKs and webhooks to extend Twenty and ship apps on top of your CRM data.`,
},
},
+ {
+ label: msg`Apps`,
+ description: msg`Extend your CRM`,
+ href: '/apps',
+ icon: IconApps,
+ preview: {
+ image: '/images/menu/developers.webp',
+ imageAlt: msg`Twenty apps marketplace`,
+ imagePosition: 'center',
+ imageScale: 1.6,
+ title: msg`Vetted apps for your workspace`,
+ description: msg`Install call recording, enrichment, Slack, Linear and more — every app built and maintained by Twenty.`,
+ },
+ },
{
label: msg`Partners`,
description: msg`Find a Twenty partner`,