v0.4.0 - New Organisation, and Modular Architecture

[mgks]

Hello community! 👋

I am excited to announce the next major evolution of this project. What started as a minimalist tool under @mgks/docmd has grown into a robust static site generator. To support the next phase of growth, stability, and enterprise-grade features, we are making significant structural changes.

We are officially kicking off the development of docmd v0.4.x.

1. New Home, New Identity

We are moving from a personal project structure to a dedicated organization.

• GitHub Organization: github.com/docmd-io
• NPM Scope: The package is moving from @mgks/docmd to @docmd/core (and related packages).
• Website: Our new home is live at docmd.io.

2. The Shift to Modular Architecture

Version 0.3.x is stable, but it is monolithic. To achieve features like Browser-based Live Editing and Plugin Ecosystems, we need to decouple the core logic from the file system.

The v0.4.0 Monorepo Structure:

• packages/cli: The command-line interface you know and love (init, dev, build). This handles the file watching and local server logic.
• packages/core: The isomorphic brain of docmd. It takes Markdown and Config in, and spits HTML out. No file system dependencies. Runs in Node.js, Browsers, and Edge workers.
• packages/theme-default: Our built-in themes (Sky, Ruby, Retro) extracted into a standalone package.
• packages/live: The engine powering the new Live Editor.

3. Why are we doing this?

• Stability: Separating concerns allows us to write better tests for the core logic without worrying about the CLI environment.
• Portability: You will be able to embed the docmd compiler directly into your own React/Vue/Svelte apps.
• Extensibility: This architecture paves the way for a proper Plugin API in v0.5.x.

4. We want your feedback!

This is an open source project, and we want to build what you need.

• What features are missing from v0.3.x?
• What pain points do you have with the current configuration?
• Are there specific integrations you need?

Please drop your thoughts, feature requests, or questions below. ⬇️

[mgks]

Well, this is outdated now.