brefphp · mnapoli · Jul 4, 2026 · Jul 4, 2026 · Jul 4, 2026 · Jul 4, 2026
diff --git a/docs/_meta.json → docs/_meta.js b/docs/_meta.json → docs/_meta.js
@@ -1,4 +1,4 @@
-{
+export default {
   "index": "What is Bref and serverless?",
   "-- Getting started": {
     "type": "separator",
@@ -56,4 +56,4 @@
   "cloud-security": {
     "title": "Security"
   }
-}
+}
diff --git a/docs/case-studies/craft-cloud.mdx b/docs/case-studies/craft-cloud.mdx
@@ -1,11 +1,11 @@
-import { NextSeo } from 'next-seo';
+---
+title: "Bref case study: How Craft CMS built Craft Cloud"
+description: Craft Cloud is built on AWS and Cloudflare and uses Bref to run Craft CMS (and PHP) at scale on AWS Lambda
+---
+
 import Image from 'next/image';
 import illustration from './craft-cloud/illustration.png';
 
-<NextSeo
-    title="Bref case study: How Craft CMS built Craft Cloud"
-    description="Craft Cloud is built on AWS and Cloudflare and uses Bref to run Craft CMS (and PHP) at scale on AWS Lambda" />
-
 # How Craft CMS built Craft Cloud
 
 <div className="mt-6 text-gray-500 text-lg">

diff --git a/docs/case-studies.mdx → docs/case-studies/index.mdx b/docs/case-studies.mdx → docs/case-studies/index.mdx
@@ -1,6 +1,7 @@
-import { NextSeo } from 'next-seo';
-
-<NextSeo description="A collection of case studies of serverless PHP applications built using Bref. Learn about performance, costs and migrations from existing projects." />
+---
+asIndexPage: true
+description: A collection of case studies of serverless PHP applications built using Bref. Learn about performance, costs and migrations from existing projects.
+---
 
 # Case studies
 

diff --git a/docs/case-studies/treezor.mdx b/docs/case-studies/treezor.mdx
@@ -1,11 +1,11 @@
-import { NextSeo } from 'next-seo';
+---
+title: "Bref case study: How Treezor runs a serverless banking platform with Bref"
+description: Treezor migrated a legacy PHP application from servers to serverless on AWS Lambda. They gained increased scalability, faster response times and fewer production incidents.
+---
+
 import Image from 'next/image';
 import illustration from './treezor/treezor-illustration.jpeg';
 
-<NextSeo
-    title="Bref case study: How Treezor runs a serverless banking platform with Bref"
-    description="Treezor migrated a legacy PHP application from servers to serverless on AWS Lambda. They gained increased scalability, faster response times and fewer production incidents." />
-
 # Treezor: a serverless banking platform
 
 <div className="mt-6 text-gray-500 text-lg">

diff --git a/docs/cloud-deploy.mdx b/docs/cloud-deploy.mdx
@@ -1,10 +1,11 @@
-import { Callout, Steps, Cards, Card } from 'nextra/components';
-// Path relative to the copy in the `website/` folder
-import { LaravelIcon } from '../../components/icons/LaravelIcon';
-import { SymfonyIcon } from '../../components/icons/SymfonyIcon';
-import { NextSeo } from 'next-seo';
+---
+description: How to deploy Bref application using Bref Cloud.
+---
 
-<NextSeo description="How to deploy Bref application using Bref Cloud." />
+import { Callout, Steps, Cards } from 'nextra/components';
+// Path relative to the copy in the `website/` folder
+import { LaravelIcon } from '../../src/components/icons/LaravelIcon';
+import { SymfonyIcon } from '../../src/components/icons/SymfonyIcon';
 
 # Deployment
 
@@ -13,9 +14,9 @@ Bref Cloud deploys application using Bref's `serverless.yml` file.
 If you haven't gotten started with Bref, follow the guide corresponding to your framework:
 
 <Cards num={2}>
-    <Card icon={<LaravelIcon />} title="Get started with Laravel" arrow="true" href="/docs/laravel/getting-started" />
-    <Card icon={<SymfonyIcon />} title="Get started with Symfony" arrow="true" href="/docs/symfony/getting-started" />
-    <Card title="Get started with any PHP framework" arrow="true" href="/docs/default/getting-started" />
+    <Cards.Card icon={<LaravelIcon />} title="Get started with Laravel" arrow="true" href="/docs/laravel/getting-started" />
+    <Cards.Card icon={<SymfonyIcon />} title="Get started with Symfony" arrow="true" href="/docs/symfony/getting-started" />
+    <Cards.Card title="Get started with any PHP framework" arrow="true" href="/docs/default/getting-started" />
 </Cards>
 
 The main difference with Bref Cloud is that you don't deploy by running `serverless deploy`. Instead, you deploy by running:

diff --git a/docs/cloud-getting-started.mdx b/docs/cloud-getting-started.mdx
@@ -1,7 +1,8 @@
-import { NextSeo } from 'next-seo';
-import { Callout } from 'nextra/components';
+---
+description: Installing the Bref CLI.
+---
 
-<NextSeo description="Installing the Bref CLI." />
+import { Callout } from 'nextra/components';
 
 # Getting started with Bref Cloud
 

diff --git a/docs/cloud-security.mdx b/docs/cloud-security.mdx
@@ -1,7 +1,8 @@
-import { NextSeo } from 'next-seo';
-import { Callout } from 'nextra/components';
+---
+description: How Bref Cloud securely accesses your AWS accounts.
+---
 
-<NextSeo description="How Bref Cloud securely accesses your AWS accounts." />
+import { Callout } from 'nextra/components';
 
 # Secure access to your AWS accounts
 

diff --git a/docs/cloud.mdx b/docs/cloud.mdx
@@ -1,9 +1,10 @@
-import { NextSeo } from 'next-seo';
-import { Cards, Card } from 'nextra/components';
-import brefIcon from '../../components/icon.svg';
-import Image from 'next/image';
+---
+description: Bref Cloud documentation.
+---
 
-<NextSeo description="Bref Cloud documentation." />
+import { Cards } from 'nextra/components';
+import brefIcon from '../../src/components/icon.svg';
+import Image from 'next/image';
 
 # Bref Cloud documentation
 
@@ -14,6 +15,6 @@ To get started, [create a free Bref Cloud account](https://bref.cloud/register).
 Bref Cloud is a service that complements the open-source Bref project. It connects to all your AWS accounts to simplify permissions and access management, and provides a dashboard to manage your serverless applications.
 
 <Cards num={2}>
-    <Card icon={<Image src={brefIcon} className="size-6" />} title="Learn more about Bref Cloud" href="/cloud" />
-    <Card icon={<Image src={brefIcon} className="size-6" />} arrow={true} title="Get started with Bref Cloud" href="https://bref.cloud/register" />
+    <Cards.Card icon={<Image src={brefIcon} className="size-6" />} title="Learn more about Bref Cloud" href="/cloud" />
+    <Cards.Card icon={<Image src={brefIcon} className="size-6" />} arrow={true} title="Get started with Bref Cloud" href="https://bref.cloud/register" />
 </Cards>
diff --git a/docs/community.mdx b/docs/community.mdx
@@ -1,6 +1,6 @@
-import { NextSeo } from 'next-seo';
-
-<NextSeo description="A collection of links to places where to discuss and learn about Bref." />
+---
+description: A collection of links to places where to discuss and learn about Bref.
+---
 
 # Community
 

diff --git a/docs/default/_meta.json → docs/default/_meta.js b/docs/default/_meta.json → docs/default/_meta.js
@@ -1,4 +1,4 @@
-{
+export default {
   "getting-started": "",
   "cli-commands": "CLI commands"
-}
+}
diff --git a/docs/default/cli-commands.mdx b/docs/default/cli-commands.mdx
@@ -1,4 +1,4 @@
-import { Tab, Tabs } from 'nextra/components';
+import { Tabs } from 'nextra/components';
 
 # CLI commands
 
@@ -16,31 +16,31 @@ The function uses the [Console runtime](../runtimes/console.mdx).
 To execute the script on Lambda, run the command below:
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless bref:cli
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref command
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 We can also pass arguments to the script:
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless bref:cli --args="extra command line arguments and options"
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref command "extra command line arguments and options"
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 Our script will be invoked inside AWS Lambda and the result will be printed to the console.

diff --git a/docs/default/getting-started.mdx b/docs/default/getting-started.mdx
@@ -1,10 +1,11 @@
-import { Cards, Card, Tabs, Tab } from 'nextra/components';
-// Path relative to the copy in the `website/` folder
-import { LaravelIcon } from '../../../components/icons/LaravelIcon';
-import { SymfonyIcon } from '../../../components/icons/SymfonyIcon';
-import { NextSeo } from 'next-seo';
+---
+description: Run PHP serverless on AWS Lambda using Bref.
+---
 
-<NextSeo description="Run PHP serverless on AWS Lambda using Bref." />
+import { Cards, Tabs } from 'nextra/components';
+// Path relative to the copy in the `website/` folder
+import { LaravelIcon } from '../../../src/components/icons/LaravelIcon';
+import { SymfonyIcon } from '../../../src/components/icons/SymfonyIcon';
 
 # Getting started - Bref with any framework
 
@@ -13,8 +14,8 @@ This guide will help you deploy your first PHP application on AWS Lambda. The in
 If you are using Laravel or Symfony, check out the dedicated guides instead:
 
 <Cards num={2}>
-    <Card icon={<LaravelIcon />} title="Get started with Laravel" arrow="true" href="/docs/laravel/getting-started" />
-    <Card icon={<SymfonyIcon />} title="Get started with Symfony" arrow="true" href="/docs/symfony/getting-started" />
+    <Cards.Card icon={<LaravelIcon />} title="Get started with Laravel" arrow="true" href="/docs/laravel/getting-started" />
+    <Cards.Card icon={<SymfonyIcon />} title="Get started with Symfony" arrow="true" href="/docs/symfony/getting-started" />
 </Cards>
 
 ## Setup
@@ -82,16 +83,16 @@ You will also want to add `.serverless` to your `.gitignore`.
 To deploy, run:
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless deploy
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref deploy
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 Once the command finishes, it should print a URL like this one:

diff --git a/docs/deploy/_meta.json → docs/deploy/_meta.js b/docs/deploy/_meta.json → docs/deploy/_meta.js
@@ -1,4 +1,4 @@
-{
+export default {
   "docker": "Deploying Docker images",
   "aws-cdk": "Deploying with AWS CDK"
-}
+}
diff --git a/docs/deploy.mdx → docs/deploy/index.mdx b/docs/deploy.mdx → docs/deploy/index.mdx
@@ -1,4 +1,8 @@
-import { Callout, Tab, Tabs } from 'nextra/components';
+---
+asIndexPage: true
+---
+
+import { Callout, Tabs } from 'nextra/components';
 
 # Deployment
 
@@ -11,16 +15,16 @@ Bref can also work with any other deployment tool: Terraform, CloudFormation, SA
 To deploy to AWS an application configured with `serverless.yml`, run:
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless deploy
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref deploy
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 A `.serverless/` directory will be created. You can add it to `.gitignore`.
@@ -46,16 +50,16 @@ Now is also the best time to configure your project for production, as well as b
 Once your project is ready, you can deploy via the following command:
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless deploy
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref deploy
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 ### Reducing package size
@@ -103,19 +107,19 @@ If your application still exceeds the 250MB limit, you can [deploy via Docker im
 We can deploy the same application multiple times in completely separated environments (also called "stages" by the Serverless CLI).
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless deploy --stage=prod
         ```
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref deploy --env=prod
 
         # or
         bref deploy -e prod
         ```
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 The default environment is `dev`. The example above deploys a `prod` environment.
@@ -173,7 +177,7 @@ provider:
 You can delete a deployed environment using the `remove` command.
 
 <Tabs items={['Serverless CLI', 'Bref Cloud']}>
-    <Tab>
+    <Tabs.Tab>
         ```bash
         serverless remove
 
@@ -182,8 +186,8 @@ You can delete a deployed environment using the `remove` command.
         ```
 
         Note that because of the way Serverless Framework works, you will need to delete the contents of AWS S3 buckets manually before running this command.
-    </Tab>
-    <Tab>
+    </Tabs.Tab>
+    <Tabs.Tab>
         ```bash
         bref remove
 
@@ -192,7 +196,7 @@ You can delete a deployed environment using the `remove` command.
         ```
 
         Bref Cloud will automatically delete the contents of AWS S3 buckets.
-    </Tab>
+    </Tabs.Tab>
 </Tabs>
 
 **Deleting an environment destroys the AWS resources that were created for that environment.**

diff --git a/docs/environment/_meta.json → docs/environment/_meta.js b/docs/environment/_meta.json → docs/environment/_meta.js
@@ -1,4 +1,4 @@
-{
+export default {
   "serverless-yml": "serverless.yml",
   "variables": "Environment variables",
   "php": "",
@@ -12,4 +12,4 @@
   "aws-credentials": "AWS credentials",
   "cold-starts": "Cold starts",
   "performances": "Performance"
-}
+}
diff --git a/docs/environment/aws-credentials.mdx b/docs/environment/aws-credentials.mdx
@@ -1,7 +1,8 @@
-import { NextSeo } from 'next-seo';
-import { Callout, Tabs } from 'nextra/components';
+---
+description: Access other AWS services from AWS Lambda by using the built-in AWS credentials.
+---
 
-<NextSeo description="Access other AWS services from AWS Lambda by using the built-in AWS credentials." />
+import { Callout, Tabs } from 'nextra/components';
 
 # AWS credentials on AWS Lambda