This website is built using Docusaurus 3, a modern static website generator.

The documentation is hosted in the Platformatic repository.

1. Create a working directory and navigate into it

mkdir /workdir
cd /workdir

2. Clone the Platformatic repositories

# Clone the main Platformatic repository
git clone https://github.com/platformatic/platformatic.git

# Clone the OSS repository
git clone https://github.com/platformatic/oss.git

After cloning, your working directory (/workdir) should contain:

• /platformatic
• /oss

3. Install dependencies in both repositories

Navigate to each directory and run npm install:

# Install dependencies in the platformatic repository
cd platformatic
npm install
cd ..

# Install dependencies in the oss repository
cd oss
npm install
cd ..

4. Navigate to the OSS directory

cd oss

Step 1: Setup the docs environment variable

# This sets the DOCS variable to the docs directory within the cloned Platformatic repository
export DOCS=$PWD/../platformatic/docs

Step 2: Start the development server

npm run start

Deployment is managed automatically through GitHub Actions. Check the workflow configurations in the .github folder within the OSS directory for details.

We keep online only the last 5 versions of Platformatic backwards. Every time a new version is realeased, this repository is tagged with vX.Y.Z.

To generate the documentation for a specific version, checkout the related tag and run the development server.

Deleting directories within ./docs may cause Docusaurus to crash. If this happens, stop the server (Ctrl+C) and restart it.