platformOS Status Report — April 8, 2025
Agnes Kanizsai | April 8, 2025

platformOS Design System
We are currently working on the renewal of our marketing site, which will feature a trendy new design, updated content, and user-friendly, consistent navigation. Alongside the website update, we will also release matching marketing and social media materials to ensure a cohesive brand experience.
We made major updates to the structure of the platformOS Design System.
Reason:
We had outgrown our existing templates—there were far too many of them.
Solutions were stored in the same file, which increased file complexity.
We’re currently updating variable names to ensure consistency between design and implementation. Since these updates affect all future projects and files, it's essential to work from an up-to-date system.
Managing design file updates was difficult, especially when integrating new features back into the MVP.
We wanted extended customizability and improved branding possibilities.
What we did:
Separated core components from solution-specific ones.
Set up a structured library system and created consistent file covers.
Published the Core Component Library—all solutions now reference this.
Defined the necessary libraries for each solution to ensure correct usage of assets and components.
Consolidated all flows into a single page within each solution file for easier navigation and design swapping.
Introduced plugins to automatically swap Variables (enabling easy theming via design tokens).
With this setup:
✅ Component modifications automatically update all linked projects (except for locally overridden tokens).
✅ Since all components link back to a single Core Library, copying files causes fewer issues.
✅ We can now update our solutions with new features more easily.
✅ Solutions can be easily shared with partners.
platformOS Community Solution
UX — Strengthening the platformOS Community Solution, Discovery Phase
At platformOS, our strategic vision prioritizes developing an exceptional Community Solution capable of addressing unified, broad-based community needs. Recognizing the diversity of our clients and their users, our Discovery phase focused intensively on creating generalized yet highly adaptable community personas and a versatile modular architecture. This foundational approach is essential for delivering scalable, personalized community experiences suited to a wide variety of industries and organizational contexts.
Strategic Focus: Understanding and Mapping Universal Community Needs
In our current discovery phase, we’ve undertaken a UX discovery phase to deeply understand generalized community user expectations, motivations, and behaviors.
Our methodologies included:
Generalized Community Personas: Developed flexible, industry-agnostic personas that clearly define universal user types and motivations. This strategic effort ensures that our Community Solution remains highly adaptable and relevant to diverse clients.
Persona-based UX Flow and Feature Prioritization: Translated these personas into detailed UX flows that prioritize essential community activities and features.
Leveraging Community Best Practices
We have meticulously integrated learnings from industry-leading communities, to align our UX strategy closely with proven community best practices.
Our key approach is a highly flexible, three-tiered modular community architecture that supports multiple segmentation approaches, whether organized around products, topics, or dynamic user interests. This modular framework enables rapid deployment, easier maintenance, and scalability, significantly enhancing our solution’s adaptability to client-specific requirements.
Flexible Homepages: Modular homepage components tailored to client needs and user engagement preferences.
Segment-driven Navigation: Clearly defined primary navigation, enabling intuitive access to community spaces and related content.
What’s Next: UX Wireframing and Transition to UI Design
Moving forward, our next phase will involve detailed UX wireframing, translating strategic insights and the modular information architecture into tangible, visual representations. This critical step prepares us to transition seamlessly to UI design, ensuring that the final product aligns closely with best practices and refined user needs identified during discovery.
Once completed, our partners and potential clients will benefit from a highly flexible, ready-to-implement Community Solution capable of delivering exceptional user experiences tailored precisely to their unique contexts.
By prioritizing this flexible, modular approach, we ensure platformOS remains a valuable, future-proof asset capable of consistently meeting and exceeding evolving community expectations.
Docs as Code Fundamentals Course
We’ve added two new lessons to Module 2 of our Docs as Code Fundamentals course:
Lesson 1: Markup languages: Learn how markup languages like Markdown are used in documentation, how to convert content into structured markup, and how tools like MDX, Google Docs add-ons, and even LLMs can support your writing and migration workflows.
Lesson 2: Topic types: Discover how structured topic types (concept, task, reference) improve clarity and consistency in documentation. This lesson also covers additional topic types, the role of templates, and how LLMs can support structured authoring.
Stay tuned for Module 2 – Lesson 3: Style guides!
Documentation
We have published a guide detailing the setup of a Continuous Integration (CI) pipeline for platformOS projects using GitHub Actions. This documentation provides step-by-step instructions on establishing a release pool of pre-configured instances, securely managing GitHub secrets, and configuring workflow files to automate testing processes.
Development
To learn more about the most recent updates, enhancements and fixes in platformOS, check out our latest release note: platformOS Release Note 11 March, 2025 — Translation caching improved, fixed accept header construction
FIXED
Fixed wrong "Accept" header construction
IMPROVED
Improved internal Translations caching mechanism
platformOS Release Note 18 February, 2025 — Security fix for sanitizing HTML for old instances
IMPROVED
Staging email interceptor will now move cc and bcc recipients to the subject line as well
Check out the pos-cli release notes as well:
5.4.0
Improvement: pos-cli modules download
will by default download version defined in app/pos-modules.lock.json file Improvement: pos-cli modules download
will automatically download all dependencies defined in module's template-values.json file if they do not exist yet Improvement: Add –force-dependencies flag to pos-cli modules download
command to force re-downloading dependencies
Subscribe: get status reports in email
Interested in knowing more about partnering with platformOS?
Ensure your project’s success with the power of platformOS.