🌐 website — BubuStack Documentation & Website

The official website and documentation for BubuStack, the Kubernetes-native workflow orchestration platform.

🔗 Quick Links

• Live site: https://bubustack.io
• Docs: https://bubustack.io/docs
• Examples: https://github.com/bubustack/examples

🏗️ Built With

• Docusaurus 3 — static site generator
• React 19 — UI components
• Mermaid — diagrams in Markdown

🚀 Local Development

Prerequisites

• Node.js 20+
• npm

Run locally

npm install
npm start

This starts a local development server at http://localhost:3000. Most changes are reflected live without restarting.

Build

npm run build

Generates static files into the build directory.

Serve the build

npm run serve

📁 Project Structure

docs/               Markdown documentation (Docusaurus content)
src/
  components/       React components (homepage sections, features)
  css/              Global styles
  pages/            Custom pages (homepage)
static/             Static assets (images, favicon)
docusaurus.config.ts  Site configuration
sidebars.ts         Documentation sidebar structure

✏️ Contributing to Docs

Every documentation page has an "Edit this page" link at the bottom that takes you directly to the source file on GitHub. This is the easiest way to suggest improvements.

For larger changes:

1. Fork this repository
2. Create a branch
3. Edit or add Markdown files in docs/
4. Run npm start to preview locally
5. Submit a pull request

See CONTRIBUTING.md for full guidelines.

🧱 BubuStack Ecosystem

Repository	Role
bobrapet	Kubernetes operator — CRDs, controllers, webhooks
bubu-sdk-go	Go SDK for building Engrams and Impulses
bobravoz-grpc	gRPC streaming transport hub
examples	Example workflows and templates
website	This repository — documentation and website

📄 License

Copyright 2026 BubuStack.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.