diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
new file mode 100644
index 0000000..936111e
--- /dev/null
+++ b/.github/workflows/deploy-docs.yml
@@ -0,0 +1,59 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'website/**'
+ - '.github/workflows/deploy-docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: 'pages'
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22
+
+ - name: Install dependencies
+ working-directory: website
+ run: npm install
+
+ - name: Build
+ working-directory: website
+ run: npm run build
+
+ - name: Upload artifact
+ uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ runs-on: ubuntu-latest
+ needs: build
+ permissions:
+ pages: write
+ id-token: write
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v4
+
diff --git a/website/.gitignore b/website/.gitignore
new file mode 100644
index 0000000..5e3df8f
--- /dev/null
+++ b/website/.gitignore
@@ -0,0 +1,25 @@
+# Dependencies
+node_modules/
+
+# Next.js
+.next/
+out/
+
+# Build
+dist/
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Local env files
+.env*.local
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
diff --git a/website/app/[[...mdxPath]]/page.tsx b/website/app/[[...mdxPath]]/page.tsx
new file mode 100644
index 0000000..ae2c92f
--- /dev/null
+++ b/website/app/[[...mdxPath]]/page.tsx
@@ -0,0 +1,23 @@
+import { generateStaticParamsFor, importPage } from 'nextra/pages';
+import { useMDXComponents } from 'nextra-theme-docs';
+
+export const generateStaticParams = generateStaticParamsFor('mdxPath');
+
+export async function generateMetadata(props: { params: Promise<{ mdxPath?: string[] }> }) {
+ const params = await props.params;
+ const { metadata } = await importPage(params.mdxPath);
+ return metadata;
+}
+
+export default async function Page(props: { params: Promise<{ mdxPath?: string[] }> }) {
+ const params = await props.params;
+ const result = await importPage(params.mdxPath);
+ const { default: MDXContent, ...rest } = result;
+ const { wrapper: Wrapper } = useMDXComponents();
+
+ return (
+
+
+
+ );
+}
diff --git a/website/app/globals.css b/website/app/globals.css
new file mode 100644
index 0000000..27547df
--- /dev/null
+++ b/website/app/globals.css
@@ -0,0 +1,20 @@
+:root {
+ --nextra-primary-hue: 263deg;
+ --nextra-primary-saturation: 70%;
+}
+
+/* Add padding to card content */
+[class*="nextra-card"] {
+ padding: 1.25rem !important;
+}
+
+[class*="nextra-card"] p {
+ margin-top: 0.5rem;
+ line-height: 1.6;
+}
+
+/* Add gap between cards */
+[class*="nextra-cards"] {
+ gap: 1rem !important;
+}
+
diff --git a/website/app/layout.tsx b/website/app/layout.tsx
new file mode 100644
index 0000000..2d7b039
--- /dev/null
+++ b/website/app/layout.tsx
@@ -0,0 +1,42 @@
+import { Head } from 'nextra/components';
+import { getPageMap } from 'nextra/page-map';
+import { Footer, Layout, Navbar } from 'nextra-theme-docs';
+import 'nextra-theme-docs/style.css';
+import './globals.css';
+
+export const metadata = {
+ title: {
+ default: 'playwright-core',
+ template: '%s | playwright-core',
+ },
+ description:
+ 'Annotation-driven Playwright testing infrastructure for better observability and traceability',
+};
+
+const logo = (
+
+ playwright-core
+
+);
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+ const pageMap = await getPageMap();
+
+ return (
+
+
+