R/AB website.

This repository stores the code used for roryashfordbentley.dev.

🗂️ Build tools, frameworks and core dependencies

The site is built using Next.js as its underlying React framework.

The site uses PayloadCMS as its CMS

The site deploys to Vercel. IMPORTANT: it's only possible to use PNPM to install Sharp successfully on Vercel

The site Database engine is MongoDB.

---

🚧 Prerequisites

The site requires that the user has mongodb-database-tools installed locally to migrate the database between local and remote server environments.

➡️ Quickstart

Clone this repository:

git clone git@github.com:roryashfordbentley/rab-website-cms.dev.git

Install dependencies

cd app
pnpm install

Run local development environment

pnpm run dev

---

🖥️ Project command reference

All commands are run from the root of the project, from a terminal:

Command	Action
pnpm install	Installs dependencies
pnpm run dev	Starts local dev server at localhost:4321
pnpm run dev-storybook	Runs local dev server and storybook instance
pnpm run build	Runs a Next build
pnpm run create-component [NAME]	Scaffolds a new component with stories and css
pnpm run create-block [NAME]	Scaffolds a new block with stories and css

Database commands

To move the database from local to remote server, or visa-versa the following commands can be used.

Migrate from local to MongoDB Atlas cluster (local to remote)

Backup

mongodump --uri="mongodb://127.0.0.1:27017/<local_database_name>" --out ~/Desktop/mongodb-backup

Restore

mongorestore --uri="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/<database_name>" ~/Desktop/mongodb-backup/<database_name> --drop

Migrate from MongoDB Atlas cluster (remote to local)

Backup

mongodump --uri="mongodb+srv://<username>:<password>@<host>/<remote_database_name>" --out ~/Desktop/mongodb-backup

Restore

mongorestore --uri="mongodb://127.0.0.1:27017/<local_database_name>" ~/Desktop/mongodb-backup/<local_database_name> --drop