Docs/blog (#56)

* feature(docs): blog pages redesigned, new blog posts

* fix(docs): blog - css and content fixes

Author: jan-jagoda

.changeset/clean-tables-smell.md

@@ -0,0 +1,5 @@
+---
+'@o2s/docs': patch
+---
+
+fix(docs): blog - css and content fixes

.changeset/tame-taxis-lick.md

@@ -0,0 +1,5 @@
+---
+'@o2s/docs': patch
+---
+
+blog redesign and new posts

apps/docs/blog/2025-03-10-o2s-released.md

@@ -0,0 +1,85 @@
+---
+slug: open-self-service-release
+title: First release of Open Self Service
+tags: [releases]
+authors: [jan.jagoda]
+toc_max_heading_level: 2
+---
+
+# First release of Open Self Service
+
+We're excited to announce the first release of **Open Self Service (O2S)** – an open-source framework for building composable, API-agnostic customer service & support frontends.
+
+<!--truncate-->
+
+As promised, the project went live on **March 10th, 2025**, together with our public roadmap. In the coming weeks, we’ll focus on building a community of developers and contributors around the project.
+
+We also have a lot of improvements and new features planned — all listed in our [Roadmap](2025-03-10-roadmap.md). You’re invited to help shape it with us.
+
+## What is Open Self Service?
+
+**Open Self Service (O2S)** is a developer toolkit for building enterprise-grade, API-first, composable frontend apps for customer support.
+
+Built on Hycom.digital’s real-world experience with MACH-based e-commerce and customer service solutions, technically inspired by composable commerce frontends.
+
+Open Self Service brings the same architectural benefits to customer service portals — while remaining flexible enough for any API-driven frontend.
+
+## What’s included?
+
+### Framework capabilities
+
+- **Frontend app starter**
+  Built with **Next.js** and fully manageable via headless CMS (currently integrated with Strapi). You get routing, localization, theming, and extensible UI components (based on Tailwind + shadcn/ui).
+
+- **API Harmonization Server**
+  A backend-for-frontend layer based on **NestJS** that integrates multiple APIs, orchestrates data, and delivers it in a unified format to the frontend app.
+
+- **SDK**
+  TypeScript SDK that provides a typed interface to access harmonized APIs from your web, mobile, or chatbot applications.
+
+- **Pre-built integrations**
+  Available for CMS (Strapi), Auth (NextAuth), and search (planned), with more to come (CRM, ERP, commerce, and others).
+
+- **Fully customizable**
+  Everything in O2S is modular: the frontend, API harmonization, integrations, and UI components can be extended, replaced, or removed.
+
+### Built-in frontend features
+
+O2S ships with working views and pages that reflect key capabilities of modern customer service portals (inspired by [Gartner’s 11 Fundamental Capabilities](https://www.gartner.com/en/customer-service-support/topics/self-service-customer-service)).
+
+You can use them out of the box or as a starting point for further customization.
+
+- **User Account & Settings** – manage user profiles, security, and preferences
+- **Dashboard** – unified overview of services, products, tickets, and invoices
+- **Case Management** – submit and track tickets or service requests
+- **Payments & Invoices** – access transaction history and download invoices
+- **Knowledge Base** – full-text search and category-based navigation
+- **Services & Products** – see product subscriptions, warranties, and details
+- **Notifications** – view in-app messages and system alerts
+
+To check what's currently available and what's in the works [follow the roadmap here.](2025-03-10-roadmap.md)
+
+---
+
+## Links & resources
+
+**Documentation**
+[https://www.openselfservice.com/docs](https://www.openselfservice.com/docs)
+
+**Get started**
+[Getting Started guide](https://www.openselfservice.com/docs/getting-started)
+
+**GitHub repository**
+[https://github.com/o2sdev/openselfservice](https://github.com/o2sdev/openselfservice)
+
+
+## Want to contribute or give feedback?
+
+Contact us at [[email protected]](mailto:[email protected])
+or share feedback via GitHub [Issues](https://github.com/o2sdev/openselfservice/issues) or [Discussions](https://github.com/o2sdev/openselfservice/discussions).
+
+Thanks for checking it out. If you like the project, give us a ⭐ on GitHub, try it out, and let us know what you think.
+
+We're aiming to make building customer self-service frontends easier, faster, and truly composable.
+
+

apps/docs/blog/roadmap.md renamed to apps/docs/blog/2025-03-10-roadmap.md

@@ -1,12 +1,17 @@
 ---
 slug: roadmap
-title: Roadmap
+title: Roadmap announcement
+tags: [releases]
+authors: [jan.jagoda, marcin.krasowski]
+toc_max_heading_level: 2
 ---
 
 # Roadmap
 
 Open Self Service (O2S) is continuously evolving. Below is an outline of upcoming enhancements and planned features.
 
+<!--truncate-->
+
 ## Framework related
 
 ### Fixes & improvements

apps/docs/blog/2025-03-27-roadmap-update.md

@@ -0,0 +1,99 @@
+---
+slug: roadmap-update-2025-03
+title: Update on our roadmap and current development status
+tags: [releases]
+authors: [jan.jagoda, marcin.krasowski]
+toc_max_heading_level: 2
+---
+
+# What’s next for Open Self Service? A look at our roadmap
+
+Open Self Service (O2S) was launched a few weeks ago and we’ve already started working on the next set of improvements, new features, and fixes to make it better.
+
+In this post, we’re sharing what we’ve shipped so far, what’s currently in progress, and what’s next on the roadmap. Whether you’re exploring O2S or already building with it, this is a quick look at where we’re heading.
+
+<!--truncate-->
+
+## What we've delivered so far
+
+After release, we’ve focused on early stability, initial fixes, and kicked off development of upcoming core features. You can track all updates on our [GitHub Releases page](https://github.com/o2sdev/openselfservice/releases).
+
+**Recent updates include:**
+- Initial bugfixes in UI and UX
+- Technical improvements to frontend app, harmonization server app, integrations and SDK
+- Preparations for new features that are coming in the next weeks
+
+## What we’re working on now
+
+We're moving fast with some new features and improvements that will roll out over the next few weeks:
+
+### A new look and feel
+
+Our UX/UI team has redesigned the frontend app with a cleaner, more professional look. If you’re one of those who “eat with their eyes 😉” this will be worth checking out. Below is a sneak peek:
+![new-design-preview](./assets/o2s-features-8-min.jpg)
+
+### Services management pages
+
+The frontend app will soon include views related to managing services – including service overviews & detail pages.
+![services-preview](./assets/o2s-features-6-min.jpg)
+
+### Knowledge base (with search)
+
+We're laying the foundations for an intelligent knowledge base:
+
+- Strapi content models have been defined
+- Algolia integration is complete and will power the search
+- Frontend pages for browsing and searching articles are in development
+
+![kb-preview](./assets/o2s-features-7-min.jpg)
+
+### SurveyJS integration
+
+We’ve integrated SurveyJS to handle custom form flows, which will first be used for **case submission** (e.g., submitting support tickets).
+
+## Coming soon
+
+Here's what we plan to ship in the next phase:
+
+### Context switching
+
+We're working on a **user/company context switcher** to support multi-org setups – a must-have for B2B portals.
+
+### Predefined Strapi models
+
+We’ll publish our Strapi content models and example content so that you can bootstrap your CMS easily or replicate the structure.
+
+### Feature modularization
+
+The frontend app will become even more flexible:
+
+- Features will be modularized so you can **disable** or **include only the ones you need**
+- Improved scalability and maintainability for custom setups
+
+### Expanded user account area
+
+Additional features are coming to the **User Account** section – user data editing screen.
+
+### Storybook for UI documentation
+
+A **Storybook** instance is in the works to document and preview all reusable UI components from our `ui` package.
+
+## More integrations
+
+We're currently reviewing a list of potential integrations – some will be selected and added to the roadmap soon. These may include:
+
+- Commerce APIs
+- CRM systems
+- AI assistants
+- Other common customer service backends
+
+## Article on Strapi integration
+
+We’re also preparing an in-depth technical guide covering how we built the Strapi CMS integration with O2S – including content modeling, connecting to the Harmonization server, and managing layouts with headless CMS principles.
+
+## We’d love your feedback
+
+Open Self Service is an open-source framework for building MACH-based, modern frontend apps, focused on customer service & support. If you’re using O2S, thinking about contributing, or just exploring what's possible, don’t hesitate to reach out or create an issue.
+
+Contact us at [[email protected]](mailto:[email protected])
+or share feedback via GitHub [Issues](https://github.com/o2sdev/openselfservice/issues) or [Discussions](https://github.com/o2sdev/openselfservice/discussions).

apps/docs/blog/assets/o2s-features-6-min.jpg

@@ -6,3 +6,12 @@ marcin.krasowski:
   page: true
   socials:
     github: marcinkrasowski
+
+jan.jagoda:
+    name: Jan Jagoda
+    title: Technical Product Owner @ O2S
+    url: https://github.com/jan-jagoda
+    image_url: https://avatars.githubusercontent.com/u/32363100?v=4
+    page: true
+    socials:
+        github: jan-jagoda