---
title: AfricaOS Changelog
description: A clear timeline of every AfricaOS release, what changed, why it matters, and how to update. No noise, just the changes that affect your workspace.
---

<Badge variant="accent">Updated with each release</Badge> <Badge variant="success">RSS available</Badge> <span className="text-sm text-muted-foreground ml-2">Dated and versioned, newest first</span>

## What you will find here

This is not general documentation. This site has one purpose: to make changes obvious and actionable.

<CardGroup cols={3}>
  <Card title="Versioned releases" icon="tag" href="/changelog/v1-0-0">
    Each entry is a dated, immutable release with a version number and a concise change list.
  </Card>
  <Card title="Scope and impact" icon="shield-check">
    What changed, who it affects, and whether you need to act. Breaking changes are called out first.
  </Card>
  <Card title="Upgrade guidance" icon="arrow-up-circle">
    Migration notes and links to the main docs when a change needs setup or data moves.
  </Card>
</CardGroup>

> **How to use this changelog**
>
> Start with the latest entry in **Changelog**, then scan back only as far as your current version. If you are on v1.0.0, you only need what came after it. Each entry lists the version, date, and change type so you can decide in seconds.

## How AfricaOS ships

AfricaOS is modular, so releases are small and focused. The format stays consistent so the timeline stays scannable.

1. **Dated releases**

    Every entry carries a release date and a version. Dates use a long format like January 1, 2026 for clarity, never ambiguous dashes.

2. **Typed changes**

    Changes are grouped as Feature, Fix, Improvement, or Breaking. Breaking changes include what to do before you update.

3. **Linked context**

    When a change needs more than a line, the entry links to the relevant guide in the main AfricaOS documentation.

## Start here

<CardGroup cols={2}>
  <Card title="Browse the timeline" icon="clock" href="/changelog/v1-0-0">
    Open the latest release and read what is new. Use the sidebar to move between versions.
  </Card>
  <Card title="Subscribe to updates" icon="rss">
    Add <code>/changelog/rss.xml</code> to your reader to get new releases as they publish.
  </Card>
</CardGroup>

### What counts as a release

- **Features** New modules, APIs, or capabilities you can adopt
- **Improvements** Faster, clearer, or more reliable behavior in existing flows
- **Fixes** Corrections that remove known issues without changing the contract
- **Breaking** Changes that need your attention before you deploy

> **Staying current**
>
> AfricaOS does not use silent releases. If an entry is here, it shipped. If it is not here, it did not ship. Use this page as the source of truth for what is live.

## For readers and for agents

This changelog is built for both people and tooling. Human readers get the formatted timeline. AI agents and automation can read the same content as structured Markdown via the site discovery endpoints.

<div className="mt-8 flex flex-wrap gap-3">
  <Badge>Human readable</Badge> <Badge>Agent readable</Badge> <Badge variant="accent">Versioned history</Badge>
</div>