How to self-host OnlineWardleyMaps with Docker Compose?

Run 'docker compose up --build' from the root directory to start both frontend and API services. The frontend is accessible at http://localhost:3000, with configurable data storage via environment variables like OWM_DATA_PATH.

OnlineWardleyMaps vs Miro for Wardley Mapping?

OnlineWardleyMaps is a free, open-source tool specialized for Wardley Maps with self-hosting options, while Miro is a general visual collaboration platform with paid plans and broader features but less specific optimization for strategic mapping techniques.

Can I use OnlineWardleyMaps offline?

Yes, by running it locally via Docker or Node.js, you can use it without an internet connection. However, the online version at www.OnlineWardleyMaps.com requires internet access for initial loading.

How to export maps for use in VS Code?

Use the 'yarn package' command to generate a package that integrates with the vscode-wardley-maps extension, allowing maps to be edited and viewed directly within VS Code as per the README instructions.

Does OnlineWardleyMaps support user accounts and permissions?

No, the self-hosted version lacks user authentication or access control features; maps are stored as files via the API, so additional security measures must be implemented separately for multi-user environments.

What data storage options are available for maps?

Maps are saved as .owm files locally using the API, with configurable paths via environment variables like OWM_DATA_PATH in Docker Compose, providing simple file-based storage without database dependencies.

Open-Awesome

OnlineWardleyMaps

MITTypeScript

A free online tool for drawing Wardley Maps quickly and easily in your browser.

Visit Website GitHub

308 stars75 forks0 contributors

What is OnlineWardleyMaps?

OnlineWardleyMaps is a free, open-source web application for creating Wardley Maps, which are strategic diagrams used to visualize the evolution of business components and their market visibility. It solves the problem of making complex strategic mapping accessible and quick to produce without specialized software. The tool runs entirely in the browser and can also be self-hosted for private or organizational use.

Target Audience

Business strategists, product managers, technology leaders, and consultants who need to create and share Wardley Maps for strategic planning and communication. It's also valuable for developers and teams integrating mapping into their workflow via VS Code or Obsidian.

Value Proposition

Developers choose OnlineWardleyMaps because it's a free, open-source alternative to proprietary diagramming tools, specifically optimized for Wardley Mapping. Its self-hosting capability, Docker support, and integration with popular editors like VS Code provide flexibility and control over data and deployment.

Overview

OnlineWardleyMaps.com - Draw Wardley Maps in seconds using this free online tool

Use Cases

Best For

Creating Wardley Maps for business strategy workshops
Self-hosting a private Wardley mapping tool for internal teams
Integrating Wardley Maps into VS Code for developer workflows
Using Wardley Maps within Obsidian for personal knowledge management
Teaching and learning Wardley Mapping concepts with a hands-on tool
Storing and versioning map iterations for tracking strategic changes over time

Not Ideal For

Teams requiring real-time collaborative editing on Wardley Maps
Projects needing multi-type diagramming beyond Wardley Maps (e.g., flowcharts or UML)
Organizations seeking cloud-based SaaS with built-in team management and enterprise support

Pros & Cons

Pros

Browser Accessibility

Users can create and edit Wardley Maps directly in a web browser with no installation, as highlighted by the browser-based editor feature, making it ideal for quick strategy sessions.

Deployment Flexibility

Supports local development with Node.js/Yarn, Docker for containerization, and Docker Compose for full-stack setup, offering multiple ways to run the application tailored to different environments.

Editor Integration

Generates packages for VS Code and Obsidian plugins, extending functionality to popular developer and note-taking tools, which enhances workflow integration.

Map Versioning

Stores and manages multiple iterations of maps through the API, allowing historical tracking of strategic evolution, as specified in the map iterations support.

Cons

Technical Setup Barrier

Requires Node.js, Yarn, or Docker knowledge for local deployment, which can be challenging for non-technical users, as evidenced by the dependency instructions in the README.

Limited API Functionality

The local API only provides basic save and fetch endpoints for map data, lacking advanced features like search, user authentication, or bulk operations, which restricts integration capabilities.

No Collaboration Features

Does not include real-time multi-user editing or commenting tools, limiting its use for team-based strategic planning where collaboration is essential.

Frequently Asked Questions

Related Projects

Go-Wardley

Go Wardley maps generator

Stars36

Forks7

Last commit3 years ago

wardley-omnigraffle

Wardley Mapping stencils for OmniGraffle software

Stars22

Forks3