🌍 AfriCode Framework

> The Design System of Sovereignty
> Bridging modern web performance with the fractal geometry and rich semiotics of African heritage.

!License: AGPL v3
!Commercial License Available

Overview

AfriCode is a full-stack UI framework built on Bun and Vanilla JavaScript. It provides a reactive core, a procedural pattern engine, and a suite of high-performance Web Components designed for the African context (mobile-first, low-latency).

✨ Features

- 🧠 Reactive Core: Lightweight Proxy-based state management (core/state.js).
- 🎨 Cultural Patterns: Procedural SVG generation for Kente, Shuka, Ndebele, and more.
- 📱 Mobile Optimized: "Profound Dark" theme with responsive grids and touch targets.
- ⚡ Native Performance: Built for Bun, zero-build runtime capable.

🚀 Quick Start

$3

``bash
bun add africode
`

$3

If you are developing the framework locally:

1. Register the link: bun link (inside framework folder)
2. Use in another project: bun link africode




$3

Import the core SDK to generate patterns or use the state engine:

`javascript
import { patterns, store, components } from 'africode';

// Generate a Maasai Shuka pattern
const shukaPattern = patterns.generateShuka();
document.body.style.backgroundImage = url("${shukaPattern}");

// Use Global State
store.ui.theme = 'tanzania';
`

$3

Simply import the components to register them as Custom Elements:

`javascript
import 'africode/components';
`

Then use them in your HTML:

`html





Project Title

Content goes here...

`

📜 Licensing

AfriCode is Dual Licensed:

1. AGPL v3: For open-source projects. You must open-source your code if you use AfriCode.
2. Commercial: For proprietary projects. Contact us for a commercial license to build closed-source apps.

🤝 Contribution

We welcome contributions! Please see CONTRIBUTING.md` for details.

---
Built with ❤️ by the AfriCode Team