The first Scratch operating system to run off a custom coding language and run in actual, memory-stored files including code!

KiwiOS is a fully custom, Scratch‑built operating system environment designed to run inside the Kiwi Machine — a virtual hardware layer composed entirely of sprites, archives, and handcrafted logic. Unlike traditional OS projects that rely on extensions, lists, or heavy scripting, KiwiOS is engineered around minimalism, precision, and complete control over every subsystem. Every component, from the bootloader to the UI, is intentionally built from scratch to ensure the system behaves exactly as designed, without hidden processes or unpredictable behavior.

KiwiOS is not a simulation of Windows, macOS, or Linux. It is its own ecosystem, its own architecture, and its own design language. The system uses a custom time format, a custom file archive structure, and a custom UI framework, all optimized for performance inside the constraints of the Kiwi Machine. This gives KiwiOS a unique identity: lightweight, deterministic, and mathematically clean.

Core Design Principles

1. Minimalism by Design

KiwiOS avoids unnecessary complexity.

There are no lists, no loops for calendar decoding, no bloated subsystems.

Every feature exists because it serves a purpose, and every line of logic is intentional.

2. Full Control Over the Environment

Because the Kiwi Machine is built entirely from sprites and archives, KiwiOS has complete control over:

• rendering

• input

• file access

• system timing

Nothing is outsourced. Nothing is abstracted away.

3. Mathematical Consistency

KiwiOS uses a custom decimal‑year time system that converts smoothly into a year‑and‑month format. This avoids the irregularities of the Gregorian calendar while still giving the OS a real sense of time progression.

4. Archive‑Driven Architecture

All system files, resources, and metadata are stored in a custom archive format.

This allows:

• fast loading

• compact storage

• predictable behavior

• easy versioning

The OS never relies on external storage structures.

System Components

Bootloader

The bootloader initializes the Kiwi Machine, loads system archives, and prepares the environment. It is intentionally small and deterministic, ensuring the OS always starts the same way.

Kernel Layer

The KiwiOS kernel handles:

• system time

• file access

It is optimized for speed and simplicity, avoiding unnecessary branching or overhead.

UI Framework

KiwiOS uses a sprite‑driven UI system with:

• modular apps

• consistent styling

Every UI element is a sprite, giving the OS a tactile, handcrafted feel.

File System

The Kiwi Archive format stores:

• metadata

• system resources

It is compact, readable, and designed specifically for KiwiOS.

Time System

KiwiOS uses a decimal‑year clock, derived from the difference between the current time and a fixed epoch. This produces a smooth, continuous time value that can be cleanly converted into:

• Year

• Month

This avoids the complexity of real‑world calendars while still giving the OS a meaningful date system.

Philosophy of KiwiOS

KiwiOS is not trying to be realistic.

It’s trying to be coherent.

Every part of the system follows the same philosophy:

• simple

• deterministic

• handcrafted

• mathematically clean

• fully under your control

It’s an OS built not to imitate reality, but to express a design vision.

What KiwiOS Represents

KiwiOS is a statement:

• that an operating system can be built from nothing but sprites

• that complexity can be replaced with elegance

• that constraints can create creativity

• that a system can be small and still feel complete

It’s a personal OS — one that reflects the choices, style, and engineering mindset behind it.

Dont mind that i used ai for this, im lazy lol :_(