Guias Dedicados:
v1.0 — Documentação Pública

AkhOS Ecosystem Docs

AkhOS é uma arquitetura modular open-source para construir portfólios, plataformas e ecossistemas digitais com identidade visual de alta definição. Este documento cobre o núcleo público, suas APIs de componente e os princípios de design que regem o ecossistema.

Escopo desta documentação

Este documento expõe exclusivamente APIs públicas, utilitários de componentes e diretrizes de design. Lógicas de backend proprietárias, credenciais de infraestrutura e endpoints privados não fazem parte deste escopo.

Filosofia

O que é o AkhOS

AkhOS não é um framework. É uma ontologia de construção — um conjunto de contratos sobre como módulos, temas e dados se relacionam dentro de um ecossistema coeso. O objetivo central é: qualquer projeto construído sobre o núcleo AkhOS deve ser intercambiável, extensível e visualmente soberano.

01

Modularidade antes de conveniência

Cada funcionalidade deve ser importável de forma isolada. Zero acoplamento implícito entre módulos.

02

Identidade como primitivo

Temas não são opcionais. O design system é uma dependência de primeira classe, não um addon.

03

Soberania de dados & LGPD

Conformidade rigorosa com a LGPD (Lei nº 13.709/2018). Dados isolados por conta, sem compartilhamento com terceiros não declarados e controle total pelo titular.

04

Extensibilidade sem fork

Customizações acontecem via API pública. Forks indicam falha de design no núcleo.

Arquitetura

Camadas do Ecossistema

O AkhOS é organizado em três camadas independentes que se comunicam via contratos de interface bem definidos:

texto
┌─────────────────────────────────────────────┐
│                  SURFACE                    │
│     Temas · Componentes UI · Templates      │
├─────────────────────────────────────────────┤
│                   CORE                      │
│   AkhCore · Router · State · Theme Engine   │
├─────────────────────────────────────────────┤
│                  ADAPTER                    │
│      Data Sources · Storage · Auth          │
└─────────────────────────────────────────────┘
Primeiros Passos

Instalação

Em desenvolvimento · Disponível em breve para desenvolvedores externos

O núcleo do AkhOS estará disponível em breve como pacote npm. O exemplo abaixo descreve o consumo futuro dos módulos:

bash
# Núcleo mínimo
npm install @akhos/core

# Com design system
npm install @akhos/core @akhos/theme-engine

# Pacote completo (core + temas + utilitários)
npm install @akhos/ecosystem

Configuração

Em desenvolvimento · Disponível em breve para desenvolvedores externos
javascript
// akhos.config.js
import { createAkhOS } from '@akhos/core'

export const akh = createAkhOS({
  project: {
    id: 'seu-projeto-id',
    locale: 'pt-BR',
  },
  theme: {
    default: 'black-brutalist',
    allowSwitch: false,
  },
  modules: {
    router: true,
    analytics: false,
    media: true,
  }
})

Importando Módulos

Em desenvolvimento · Disponível em breve para desenvolvedores externos
javascript
import { AkhRouter }    from '@akhos/core/router'
import { AkhState }     from '@akhos/core/state'
import { ThemeEngine }  from '@akhos/theme-engine'
import { MediaGrid }    from '@akhos/core/components/media-grid'
import { useAkhTheme }  from '@akhos/core/hooks'
Referência API

AkhCore API

Em desenvolvimento · Disponível em breve para desenvolvedores externos
MétodoRetornoDescrição
akh.init()Promise<void>Inicializa o ecossistema e carrega o tema padrão.
akh.getTheme()ThemeObjectRetorna o tema ativo com todos os tokens CSS resolvidos.
akh.setTheme(id)Promise<ThemeObject>Troca o tema em tempo de execução.

Utilitários de Componente

Em desenvolvimento · Disponível em breve para desenvolvedores externos
javascript
import { cx, token, spacing } from '@akhos/core/utils'

const className = cx('akh-card', isActive && 'akh-card--active')

Hooks (React / Preact)

Em desenvolvimento · Disponível em breve para desenvolvedores externos
jsx
import { useAkhTheme, useAkhState } from '@akhos/core/hooks'
Design System

Black Brutalist — Princípios

O Black Brutalist é a identidade visual fundacional do AkhOS. Cada decisão visual serve a uma função específica de leitura e hierarquia.

css
/* Tokens Canônicos AkhOS — Variáveis globais de tema */
--background:        hsl(var(--background));   /* Fundo principal Void Black */
--foreground:        hsl(var(--foreground));   /* Texto primário Bone White */
--muted-foreground:  hsl(var(--muted-foreground));/* Texto secundário e rótulos */
--border:            hsl(var(--border));       /* Bordas estruturais */

/* Proporções de Border-Radius Proporcional (Apple-like) */
--radius-sm:         var(--radius-sm);   /* Elementos pequenos */
--radius-md:         var(--radius-md);   /* Cards e painéis médios */
--radius-lg:         var(--radius-lg);   /* Containers e modais principais */
--radius-full:       var(--radius-full); /* Botões, pills e badges */
--radius:            var(--radius);      /* Token base padrão */

/* Utilitários de Vidro e Profundidade */
.glass {
  background-color: rgba(5, 5, 5, 0.65);
  backdrop-filter: blur(12px);
  border: 1px solid rgba(255, 255, 255, 0.1);
}
.glass-strong {
  background-color: rgba(5, 5, 5, 0.88);
  backdrop-filter: blur(16px);
  border: 1px solid rgba(255, 255, 255, 0.15);
}

Temas Disponíveis

Black Brutalist

Void black, tipografia crua, acento minimalista.

White Brutalist

Inversão em papel off-white.

Blue & Black

Fundo noturno profundo com acento azul.

Tokens de Design

css
/* Estrutura de Camadas */
--radius-sm: 0.25rem;
--radius-md: 0.5rem;
--radius-lg: 0.75rem;
--background: hsl(var(--background));
.glass { backdrop-filter: blur(12px); }

Extensibilidade

Em desenvolvimento · Disponível em breve para desenvolvedores externos
javascript
import { createAkhOS, definePlugin } from '@akhos/core'
Governança, Proteção & LGPD

Modelo de Segurança & Conformidade LGPD

A segurança da informação e a salvaguarda de dados pessoais e de catálogo no ecossistema AkhOS são estruturadas sob os princípios de Privacy by Design e Defesa em Profundidade.

01

Privilégio Mínimo & Sandboxing

Nenhum componente executa operações com privilégios não concedidos explicitamente. O acesso a credenciais, mídias e banco de dados é compartimentado por sandboxing.

02

Conformidade Estrita com a LGPD

Aderência total à Lei nº 13.709/2018. Coleta estritamente funcional, finalidade declarada, sem rastreamento abusivo e garantia irrevogável aos direitos de acesso, retificação e exclusão de dados pelo usuário.

03

Criptografia & Sessões Efêmeras

Todas as comunicações exigem TLS 1.3 ponta a ponta. Sessões operam via tokens criptográficos efêmeros com rotação contínua e armazenamento estritamente seguro contra extração.

04

Blindagem Ativa contra Ameaças

Defesa nativa contra injeções (SQLi, XSS, CSRF), limitação inteligente de taxa (Rate Limiting) e sanitização rigorosa de respostas e erros para jamais expor detalhes internos de infraestrutura ou dados sensíveis.

PARA CREATORS
Infraestrutura para criadores independentes

Você não precisa de um site.
Você precisa de uma vitrine com infraestrutura própria.

Enquanto outros artistas alugam espaço em plataformas que controlam seus dados, sua distribuição e sua identidade — você pode ter o seu próprio portal no ecossistema AkhOS.

Assinar agora (Plano Creators)