@fecommunity/reactpress-theme-starter 1.0.0-beta.0

package/app/knowledge/[pId]/[id]/page.tsx

@@ -0,0 +1,54 @@
+import KnowledgeChapterClient from '@/components/views/KnowledgeChapterClient'
+import { buildKnowledgeChapterMetadata, parseSiteSeoContext } from '@/lib/reactpress/contentSeo'
+import {
+  fetchKnowledgeChapterPageProps,
+  fetchSiteMeta,
+  themeApi,
+  unwrapSetting,
+  withApiRetry,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+
+export const revalidate = 60
+
+interface PageProps {
+  params: Promise<{ pId: string; id: string }>
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { pId, id } = await params
+
+  try {
+    const [data, siteMeta, settingRow] = await Promise.all([
+      withApiRetry(() => fetchKnowledgeChapterPageProps(themeApi, pId, id)),
+      withApiRetry(() => fetchSiteMeta(themeApi)),
+      withApiRetry(() => themeApi.setting.findAll()).then(unwrapSetting),
+    ])
+
+    if (!data.book?.id || !data.chapter?.id) {
+      return {}
+    }
+
+    const site = parseSiteSeoContext(settingRow, siteMeta)
+    return buildKnowledgeChapterMetadata(data.chapter, data.book, site)
+  } catch (error) {
+    console.error('[reactpress-theme-starter] knowledge chapter metadata fetch failed', error)
+    return {}
+  }
+}
+
+export default async function KnowledgeChapterPage({ params }: PageProps) {
+  const { pId, id } = await params
+
+  try {
+    const data = await withApiRetry(() => fetchKnowledgeChapterPageProps(themeApi, pId, id))
+    if (!data.book?.id || !data.chapter?.id) {
+      notFound()
+    }
+    return <KnowledgeChapterClient pId={pId} id={id} book={data.book} chapter={data.chapter} />
+  } catch (error) {
+    console.error('[reactpress-theme-starter] knowledge chapter page fetch failed', error)
+    notFound()
+  }
+}

package/app/knowledge/[pId]/page.tsx

@@ -0,0 +1,47 @@
+import KnowledgeBookClient from '@/components/views/KnowledgeBookClient'
+import {
+  buildListPageMetadata,
+  buildLocalizedListPageMetadata,
+} from '@/lib/reactpress/siteMetadata'
+import {
+  fetchKnowledgeBookPageProps,
+  themeApi,
+  withApiRetry,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+
+export const revalidate = 60
+
+interface PageProps {
+  params: Promise<{ pId: string }>
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { pId } = await params
+
+  try {
+    const data = await withApiRetry(() => fetchKnowledgeBookPageProps(themeApi, pId))
+    if (data.book?.title) {
+      return buildListPageMetadata(data.book.title, data.book.summary, `/knowledge/${pId}`)
+    }
+  } catch {
+    // fall through
+  }
+  return buildLocalizedListPageMetadata('knowledge', undefined, { path: '/knowledge' })
+}
+
+export default async function KnowledgeBookPage({ params }: PageProps) {
+  const { pId } = await params
+
+  try {
+    const data = await withApiRetry(() => fetchKnowledgeBookPageProps(themeApi, pId))
+    if (!data.book?.id) {
+      notFound()
+    }
+    return <KnowledgeBookClient pId={pId} book={data.book} otherBooks={data.otherBooks} />
+  } catch (error) {
+    console.error('[reactpress-theme-starter] knowledge book page fetch failed', error)
+    notFound()
+  }
+}

package/app/knowledge/page.tsx

@@ -0,0 +1,29 @@
+import KnowledgeClient from '@/components/views/KnowledgeClient'
+import { buildLocalizedListPageMetadata } from '@/lib/reactpress/siteMetadata'
+import {
+  fetchKnowledgeIndexPageProps,
+  themeApi,
+  withApiRetry,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata } from 'next'
+
+export const revalidate = 60
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildLocalizedListPageMetadata('knowledge', undefined, { path: '/knowledge' })
+}
+
+export default async function KnowledgePage() {
+  let books = []
+  let total = 0
+
+  try {
+    const data = await withApiRetry(() => fetchKnowledgeIndexPageProps(themeApi, 12))
+    books = data.books
+    total = data.total
+  } catch (error) {
+    console.error('[reactpress-theme-starter] knowledge page fetch failed', error)
+  }
+
+  return <KnowledgeClient initialBooks={books} total={total} />
+}

package/app/layout.tsx

@@ -0,0 +1,76 @@
+import './globals.css'
+
+import DevChunkRecovery from '@/components/shared/DevChunkRecovery'
+import SiteHeader from '@/components/layout/SiteHeader'
+import BackToTop from '@/components/layout/BackToTop'
+import ConditionalSiteFooter from '@/components/layout/ConditionalSiteFooter'
+import PageContainer from '@/components/layout/PageContainer'
+import { loadAppBootstrap } from '@/lib/reactpress/bootstrap'
+import { buildThemeStarterAppearanceCss } from '@/lib/reactpress/appearance'
+import { getApiPreconnectOrigin } from '@/lib/reactpress/env'
+import { ReactPressAppProviders } from '@/lib/reactpress/providers'
+import { buildRootMetadata } from '@/lib/reactpress/siteMetadata'
+import { DEFAULT_DESCRIPTION } from '@/lib/reactpress/seoMetadata'
+import { colorModeInitScript } from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata, Viewport } from 'next'
+
+export const revalidate = 60
+export const dynamic = 'force-dynamic'
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildRootMetadata()
+}
+
+export const viewport: Viewport = {
+  width: 'device-width',
+  initialScale: 1,
+  viewportFit: 'cover',
+}
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const bootstrap = await loadAppBootstrap('/')
+  const appearanceCss = buildThemeStarterAppearanceCss(bootstrap.themeMods)
+  const basePath = process.env.BASE_PATH || ''
+  const apiPreconnect = getApiPreconnectOrigin()
+  const rootMetadata = await buildRootMetadata()
+  const siteDescription =
+    typeof rootMetadata.description === 'string' && rootMetadata.description.trim()
+      ? rootMetadata.description
+      : DEFAULT_DESCRIPTION
+
+  return (
+    <html lang={bootstrap.initialLocale} suppressHydrationWarning>
+      <head>
+        <meta name="description" content={siteDescription} />
+        <script
+          dangerouslySetInnerHTML={{
+            __html: `document.documentElement.setAttribute('data-rp-loading','');`,
+          }}
+        />
+        {apiPreconnect ? (
+          <link rel="preconnect" href={apiPreconnect} crossOrigin="anonymous" />
+        ) : null}
+        <link rel="icon" href={`${basePath}/favicon.ico`} sizes="any" />
+        <link rel="icon" type="image/png" sizes="32x32" href={`${basePath}/favicon-32.png`} />
+        <link rel="apple-touch-icon" sizes="180x180" href={`${basePath}/apple-touch-icon.png`} />
+        <link rel="manifest" href={`${basePath}/site.webmanifest`} />
+      </head>
+      <body
+        className="flex min-h-dvh flex-col bg-[var(--bg-body)] text-[var(--main-text-color)] antialiased"
+        suppressHydrationWarning
+      >
+        <script dangerouslySetInnerHTML={{ __html: colorModeInitScript }} />
+        {appearanceCss ? <style dangerouslySetInnerHTML={{ __html: appearanceCss }} /> : null}
+        <ReactPressAppProviders bootstrap={bootstrap}>
+          <DevChunkRecovery />
+          <SiteHeader />
+          <main id="main-content" className="flex flex-1 flex-col">
+            <PageContainer className="flex flex-1 flex-col">{children}</PageContainer>
+          </main>
+          <ConditionalSiteFooter />
+          <BackToTop />
+        </ReactPressAppProviders>
+      </body>
+    </html>
+  )
+}

package/app/llms.txt/route.ts

@@ -0,0 +1,26 @@
+import { getClientSiteUrl } from '@/lib/reactpress/env'
+
+export async function GET() {
+  const siteUrl = getClientSiteUrl()
+
+  const body = `# ReactPress
+
+> One package. Your CMS in about a minute. Modern publishing platform for blogs, company sites, and content-driven products.
+
+## Links
+
+- [Home](${siteUrl}/): Latest ReactPress articles and guides
+- [Archives](${siteUrl}/archives): Browse all published articles
+- [Search](${siteUrl}/search): Search ReactPress documentation articles
+- [Tags](${siteUrl}/tags): Browse articles by tag
+- [GitHub](https://github.com/fecommunity/reactpress): Official open-source repository
+- [Official Site](https://reactpress.surge.sh/): Product overview and documentation
+`
+
+  return new Response(body, {
+    headers: {
+      'Content-Type': 'text/plain; charset=utf-8',
+      'Cache-Control': 'public, max-age=3600, s-maxage=3600',
+    },
+  })
+}

package/app/login/page.tsx

@@ -0,0 +1,17 @@
+import LoginClient from '@/components/views/LoginClient'
+import { buildNoIndexMetadata } from '@/lib/reactpress/siteMetadata'
+import { tServer } from '@/lib/reactpress/serverLocale'
+import type { Metadata } from 'next'
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildNoIndexMetadata(await tServer('pageTitleLogin'), '/login')
+}
+
+interface PageProps {
+  searchParams: Promise<{ code?: string; from?: string }>
+}
+
+export default async function LoginPage({ searchParams }: PageProps) {
+  const { code = '', from = '/' } = await searchParams
+  return <LoginClient code={code} from={from} />
+}

package/app/nav/[id]/page.tsx

@@ -0,0 +1,44 @@
+import NavDetailClient from '@/components/views/NavDetailClient'
+import { buildLocalizedListPageMetadata } from '@/lib/reactpress/siteMetadata'
+import { getServerTranslator } from '@/lib/reactpress/serverLocale'
+import { fetchSiteNavConfig } from '@fecommunity/reactpress-toolkit/theme/server'
+import { SettingProvider } from '@/lib/providers/server'
+import themeManifest from '../../../theme.json'
+import type { Metadata } from 'next'
+
+export const revalidate = 60
+
+interface PageProps {
+  params: Promise<{ id: string }>
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { id } = await params
+  const siteKey = id.split('.')[0]
+  return buildLocalizedListPageMetadata(
+    'pageTitleNavDetail',
+    { label: siteKey },
+    {
+      path: `/nav/${encodeURIComponent(id)}`,
+    }
+  )
+}
+
+export default async function NavDetailPage({ params }: PageProps) {
+  const { id } = await params
+  const siteKey = id.split('.')[0]
+  const { locale } = await getServerTranslator()
+
+  let navConfig
+  try {
+    navConfig = await fetchSiteNavConfig({
+      locale,
+      manifest: themeManifest,
+      getSetting: () => SettingProvider.getSetting(),
+    })
+  } catch (error) {
+    console.error('[reactpress-theme-starter] nav detail config fetch failed', error)
+  }
+
+  return <NavDetailClient siteKey={siteKey} navConfig={navConfig} />
+}

package/app/nav/page.tsx

@@ -0,0 +1,5 @@
+import { redirect } from 'next/navigation'
+
+export default function NavPage() {
+  redirect('/search')
+}

package/app/not-found.tsx

@@ -0,0 +1,21 @@
+'use client'
+
+import Link from '@/components/shared/Link'
+import { useLocale } from '@fecommunity/reactpress-toolkit/ui'
+
+export default function NotFound() {
+  const { t } = useLocale()
+
+  return (
+    <div className="flex min-h-[50vh] flex-col items-center justify-center py-16 text-center">
+      <h1 className="m-0 text-6xl font-bold text-[var(--primary-color)]">404</h1>
+      <p className="mt-4 text-lg text-[var(--main-text-color)]">{t('pageMissing')}</p>
+      <Link
+        href="/"
+        className="rp-primary-action mt-6 inline-block rounded-xl bg-[var(--primary-color)] px-6 py-2.5 text-white no-underline hover:opacity-95"
+      >
+        {t('backHome')}
+      </Link>
+    </div>
+  )
+}

package/app/page/[id]/page.tsx

@@ -0,0 +1,57 @@
+import CmsPageClient from '@/components/article/CmsPageClient'
+import { buildCmsPageMetadata, parseSiteSeoContext } from '@/lib/reactpress/contentSeo'
+import { coercePublishedPage } from '@/lib/reactpress/coercePublishedPage'
+import {
+  fetchCmsPageProps,
+  fetchSiteMeta,
+  themeApi,
+  unwrapSetting,
+  withApiRetry,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+
+export const revalidate = 60
+
+interface PageProps {
+  params: Promise<{ id: string }>
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { id } = await params
+
+  try {
+    const [{ page: rawPage }, siteMeta, settingRow] = await Promise.all([
+      withApiRetry(() => fetchCmsPageProps(themeApi, id)),
+      withApiRetry(() => fetchSiteMeta(themeApi)),
+      withApiRetry(() => themeApi.setting.findAll()).then(unwrapSetting),
+    ])
+
+    const page = coercePublishedPage(rawPage)
+    if (!page) {
+      return {}
+    }
+
+    const site = parseSiteSeoContext(settingRow, siteMeta)
+    return buildCmsPageMetadata(page, site)
+  } catch (error) {
+    console.error('[reactpress-theme-starter] cms page metadata fetch failed', error)
+    return {}
+  }
+}
+
+export default async function CmsPage({ params }: PageProps) {
+  const { id } = await params
+
+  try {
+    const { page: rawPage } = await withApiRetry(() => fetchCmsPageProps(themeApi, id))
+    const page = coercePublishedPage(rawPage)
+    if (!page) {
+      notFound()
+    }
+    return <CmsPageClient page={page} />
+  } catch (error) {
+    console.error('[reactpress-theme-starter] cms page fetch failed', error)
+    notFound()
+  }
+}

package/app/page.tsx

@@ -0,0 +1,61 @@
+import HomeClient from '@/components/views/HomeClient'
+import { buildHomePageMetadata } from '@/lib/reactpress/siteMetadata'
+import {
+  fetchHomePageProps,
+  resolveImageUrl,
+  themeApi,
+  withApiRetry,
+  type CarouselArticle,
+  type ListArticle,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { Metadata } from 'next'
+
+export const revalidate = 60
+
+export async function generateMetadata(): Promise<Metadata> {
+  try {
+    const data = await withApiRetry(() => fetchHomePageProps(themeApi))
+    const lcpCover = data.recommendedArticles.find((article) => article.cover)?.cover
+    const imageUrl = lcpCover ? resolveImageUrl(lcpCover, 'medium') : undefined
+    const base = await buildHomePageMetadata()
+    if (!imageUrl) return base
+    return {
+      ...base,
+      openGraph: {
+        ...base.openGraph,
+        images: [{ url: imageUrl }],
+      },
+      twitter: {
+        ...base.twitter,
+        card: 'summary_large_image',
+        images: [imageUrl],
+      },
+    }
+  } catch {
+    return buildHomePageMetadata()
+  }
+}
+
+export default async function Page() {
+  let articles: ListArticle[] = []
+  let total = 0
+  let recommendedArticles: CarouselArticle[] = []
+  try {
+    const data = await withApiRetry(() => fetchHomePageProps(themeApi))
+    articles = data.articles
+    total = data.total
+    recommendedArticles = data.recommendedArticles
+  } catch (error) {
+    console.error('[reactpress-theme-starter] home page fetch failed', error)
+  }
+
+  return (
+    <>
+      <HomeClient
+        initialArticles={articles}
+        total={total}
+        recommendedArticles={recommendedArticles}
+      />
+    </>
+  )
+}

package/app/register/page.tsx

@@ -0,0 +1,17 @@
+import AuthPageClient from '@/components/auth/AuthPageClient'
+import { buildNoIndexMetadata } from '@/lib/reactpress/siteMetadata'
+import { tServer } from '@/lib/reactpress/serverLocale'
+import type { Metadata } from 'next'
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildNoIndexMetadata(await tServer('commentNamespace.userRegister'), '/register')
+}
+
+interface PageProps {
+  searchParams: Promise<{ from?: string }>
+}
+
+export default async function RegisterPage({ searchParams }: PageProps) {
+  const { from = '/' } = await searchParams
+  return <AuthPageClient mode="register" from={from} />
+}

package/app/robots.ts

@@ -0,0 +1,14 @@
+import { getClientSiteUrl } from '@/lib/reactpress/env'
+import { MetadataRoute } from 'next'
+
+export default function robots(): MetadataRoute.Robots {
+  const siteUrl = getClientSiteUrl()
+
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+    },
+    sitemap: `${siteUrl}/sitemap.xml`,
+  }
+}

package/app/rss/route.ts

@@ -0,0 +1,82 @@
+import { ArticleProvider, CategoryProvider, SettingProvider } from '@/lib/providers/server'
+import { getClientSiteUrl } from '@/lib/reactpress/env'
+
+function escapeXml(value: string) {
+  return value
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+function resolveUrl(base: string, path: string) {
+  const normalizedBase = base.endsWith('/') ? base.slice(0, -1) : base
+  const normalizedPath = path.startsWith('/') ? path : `/${path}`
+  return `${normalizedBase}${normalizedPath}`
+}
+
+export async function GET() {
+  let articles: Awaited<ReturnType<typeof ArticleProvider.getArticles>>[0] = []
+  let setting: Awaited<ReturnType<typeof SettingProvider.getSetting>> = {
+    systemTitle: 'Blog',
+    seoDesc: 'Blog',
+    systemUrl: getClientSiteUrl(),
+  } as Awaited<ReturnType<typeof SettingProvider.getSetting>>
+  let categories: Awaited<ReturnType<typeof CategoryProvider.getCategory>> = []
+
+  try {
+    const [articlesResult, settingResult, categoriesResult] = await Promise.all([
+      ArticleProvider.getArticles({
+        page: 1,
+        pageSize: 99999,
+        status: 'publish',
+      }),
+      SettingProvider.getSetting(),
+      CategoryProvider.getCategory({ articleStatus: 'publish' }),
+    ])
+    ;[articles] = articlesResult
+    setting = settingResult
+    categories = categoriesResult
+  } catch (error) {
+    console.error('[reactpress-theme-starter] rss fetch failed', error)
+  }
+
+  const siteUrl = setting.systemUrl || getClientSiteUrl()
+  const items = articles
+    .map((article) => {
+      const categoryLabel =
+        typeof article.category === 'object' && article.category
+          ? ((article.category as { label?: string }).label ?? '')
+          : ''
+      return `
+    <item>
+      <title>${escapeXml(article.title)}</title>
+      <description><![CDATA[${article.html || article.content || ''}]]></description>
+      <link>${escapeXml(resolveUrl(siteUrl, `article/${article.id}`))}</link>
+      <guid>${escapeXml(resolveUrl(siteUrl, `article/${article.id}`))}</guid>
+      <pubDate>${new Date(article.publishAt).toUTCString()}</pubDate>
+      ${categoryLabel ? `<category>${escapeXml(categoryLabel)}</category>` : ''}
+    </item>`
+    })
+    .join('')
+
+  const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0">
+  <channel>
+    <title>${escapeXml(setting.systemTitle || 'Blog')}</title>
+    <description>${escapeXml(setting.seoDesc || setting.systemTitle || 'Blog')}</description>
+    <link>${escapeXml(siteUrl)}</link>
+    <generator>ReactPress</generator>
+    <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
+    ${categories.map((c) => `<category>${escapeXml((c as { label?: string }).label || '')}</category>`).join('')}
+    ${items}
+  </channel>
+</rss>`
+
+  return new Response(xml, {
+    headers: {
+      'Content-Type': 'text/xml; charset=utf-8',
+    },
+  })
+}

package/app/search/page.tsx

@@ -0,0 +1,46 @@
+import SearchClient from '@/components/views/SearchClient'
+import { buildLocalizedListPageMetadata } from '@/lib/reactpress/siteMetadata'
+import { getServerTranslator } from '@/lib/reactpress/serverLocale'
+import { SettingProvider } from '@/lib/providers/server'
+import {
+  fetchSearchPageProps,
+  fetchSiteNavConfig,
+  themeApi,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import themeManifest from '../../theme.json'
+import type { Metadata } from 'next'
+
+export const revalidate = 60
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildLocalizedListPageMetadata('search', undefined, { path: '/search' })
+}
+
+interface PageProps {
+  searchParams: Promise<{ keyword?: string }>
+}
+
+export default async function SearchPage({ searchParams }: PageProps) {
+  const { keyword = '' } = await searchParams
+  const trimmed = keyword.trim()
+  const { locale } = await getServerTranslator()
+
+  let articles = []
+  let navConfig
+  try {
+    const [searchData, navData] = await Promise.all([
+      fetchSearchPageProps(themeApi, trimmed),
+      fetchSiteNavConfig({
+        locale,
+        manifest: themeManifest,
+        getSetting: () => SettingProvider.getSetting(),
+      }),
+    ])
+    articles = searchData.articles
+    navConfig = navData
+  } catch (error) {
+    console.error('[reactpress-theme-starter] search page fetch failed', error)
+  }
+
+  return <SearchClient keyword={trimmed} articles={articles} navConfig={navConfig} />
+}

package/app/sitemap.ts

@@ -0,0 +1,38 @@
+import { getClientSiteUrl } from '@/lib/reactpress/env'
+import { MetadataRoute } from 'next'
+import {
+  themeApi,
+  unpackPaginatedPair,
+  withApiRetry,
+} from '@fecommunity/reactpress-toolkit/theme/server'
+import type { IArticle } from '@fecommunity/reactpress-toolkit/types'
+
+export const revalidate = 3600
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const siteUrl = getClientSiteUrl()
+
+  const staticRoutes = ['', 'blog', 'tags', 'archives', 'search'].map((route) => ({
+    url: route ? `${siteUrl}/${route}` : siteUrl,
+    lastModified: new Date(),
+  }))
+
+  let articleRoutes: MetadataRoute.Sitemap = []
+
+  try {
+    const response = await withApiRetry(() =>
+      themeApi.article.findAll({
+        query: { page: 1, pageSize: 500, status: 'publish' },
+      } as never)
+    )
+    const [articles] = unpackPaginatedPair<IArticle>(response)
+    articleRoutes = articles.map((article) => ({
+      url: `${siteUrl}/article/${article.id}`,
+      lastModified: article.updateAt ?? article.publishAt ?? new Date(),
+    }))
+  } catch (error) {
+    console.error('[reactpress-theme-starter] sitemap fetch failed', error)
+  }
+
+  return [...staticRoutes, ...articleRoutes]
+}