Welcome to the Flowork OS Content Management System. Unlike traditional CMS platforms that rely on heavy SQL databases, our blog engine runs entirely on a blazing-fast, decentralized Markdown (`.md`) parsing architecture. This ensures instantaneous load times, zero database vulnerabilities, and seamless Glassmorphism UI rendering.
This guide will walk you through the exact pipeline for creating, formatting, and registering a new article into the Flowork OS ecosystem.
---
STEP 1: Creating the Markdown File (`.md`)
Every article starts as a plain text Markdown file. You need to create a new file with a `.md` extension.
Naming Convention: Use lowercase letters and hyphens (kebab-case) for the filename. This will act as your URL slug. *Example: `my-awesome-article.md`*
The Front-Matter (Metadata)
At the very top of your `.md` file, you must include a YAML Front-Matter block. This block is enclosed by triple dashes (`---`) and contains critical metadata that the OS uses to render titles, authors, and SEO tags.Here is the required format:
```yaml --- title: "Your Epic Article Title Here" date: "YYYY-MM-DD" author: "Author Name" version: "1.0" cover: "URL_TO_YOUR_IMAGE.webp" keywords: - keyword 1 - keyword 2 ---
```
The Article Body
Directly below the second `---`, you can start writing your article using standard Markdown syntax. Our OS engine automatically supports:
* `##` for Headings (Automatically styled with dashed borders). * `text` for bold text. * ``code`` for inline code, and triple backticks for code blocks (which will be rendered inside beautiful Glassmorphism containers). * Standard HTML tags if you need advanced inline styling.
Save your file and place it into the designated directory: `/content/blog/`.
---
STEP 2: Registering the Article in `index.json`
Creating the `.md` file alone is not enough. To make your article discoverable in the main Blog Archive, populate the "Related Posts" sidebar, and activate the Global SEO Tagging system, you must register it in the master registry.
Locate and open the `index.json` file (typically located at `/content/blog/index.json`). This file contains an array of objects representing all published articles.
You must add a new JSON object to this array. The object must contain the `slug` (which strictly matches your `.md` filename without the extension), `title`, `description`, `date`, `cover`, and `keywords`.
Registry Format Example
Here is the exact format you need to append to the `index.json` array. Make sure to adjust the values to match your newly created article:
```json { "slug": "ultimate-guide-to-virtual-app", "title": "Mastering Flowork OS: The Ultimate Guide to Virtual App Studio & Workspace Templates Ecosystem", "description": "A comprehensive guide to designing Virtual Apps in RAM, OS API (sys) documentation, bypassing isolation with God Mode Proxy, and the anti-theft Workspace Template system.", "date": "2026-03-08", "cover": "https://floworkos.com/assets/ultimate-guide-to-virtual-app.webp", "keywords": [ "virtual app studio", "flowork os", "javascript api", "chrome extension proxy", "workspace template", "god mode", "development guide", "web operating system" ] }
```
Important Registration Rules:
1. Slug Matching: The `slug` value (e.g., `"ultimate-guide-to-virtual-app"`) must exactly match your filename (`ultimate-guide-to-virtual-app.md`). If they don't match, the OS will return a "Document not registered" 404 error. 2. JSON Syntax: Ensure you add a comma `,` after the previous object in the array before pasting your new object, maintaining valid JSON structure. 3. Keyword Synergy: The `keywords` array powers our internal recommendation engine. Use highly relevant tags so the AI can accurately suggest your article in the "Related Modules" and "Related Posts" widgets.
Once you save the `index.json` file, your article is instantly live across the Flowork OS ecosystem!
```
Registration for this Tutorial
To make the tutorial above live in your system, you just need to add its entry into your `/content/blog/index.json` file like this:```json { "slug": "how-to-publish-article", "title": "The Complete Guide to Publishing Articles in Flowork OS", "description": "Learn the step-by-step pipeline for creating markdown articles, setting up YAML front-matter, and registering posts in the index.json registry.", "date": "2026-03-08", "cover": "https://floworkos.com/assets/how-to-publish-cover.webp", "keywords": [ "content management", "markdown", "blog publishing", "flowork os", "documentation", "tutorial" ] }
```