architus

Implementation documentation for the architus ecosystem, including the microservice-based backend application as well as the React-based web dashboard. Built in Gatsby.js, React, and MDX

🚀 Getting Started

Setup

To set up the docs.archit.us website locally, you'll need to have Node.js installed. Once installed, run the following commands to download dependencies:

npm install -g yarn
yarn install

📝 Authoring Documentation

To edit documentation or add new pages, add .md or .mdx (preferred) files to the docs/ folder in the repository root. Any files automatically result in generated pages at the same public path as their relative path, starting from the docs/ folder. To add a page with the same name/path as a subdirectory, simply add a file named index.md or index.mdx.

File Format

---
title: (Required). Name that appears in the title <h1> and in the side NavBar
shortTitle: (Optional; defaults to title). Name that appears in the title bar & breadcrumb
---

# Markdown content

See external guides for specifics on Markdown syntax

📡 Development Server

Similar to the frontend web dashboard, there are two options to preview the app while developing: a hot reload-enabled development server (recommended) and a statically-generated site preview.

Hot-reload-enabled

yarn start

Statically-generated preview

yarn build
yarn serve

Code Style

docs.archit.us uses eslint and prettier to enforce JavaScript code style across the repository. To run the linter locally, run:

yarn run lint

GitHub