CyberEco¶

The open digital ecosystem for community-driven applications.

Build privacy-first, community-owned apps with a shared data layer, flexible permissions, and seamless cross-app identity.

Get Started View on GitHub

Packages¶

Four composable npm packages — types, Firebase adapter, auth, and services — that form a complete data layer for any application.

Explore Packages

Hub App¶

An Astro + React application providing identity management, privacy controls, and a unified dashboard for the CyberEco ecosystem.

Hub Overview

Privacy First¶

StorageAdapter abstraction enables future migration to IPFS, blockchain, or encrypted computation — without changing application code.

Architecture

MCP Server¶

AI-native integration via Model Context Protocol — 7 tools, 22 resources, and 4 prompts for building with CyberEco.

MCP Docs

Quick Example¶

Install the packages and create a data layer in under 5 minutes:

npm install @cyber-eco/types @cyber-eco/firebase @cyber-eco/services

import { FirebaseStorageAdapter } from '@cyber-eco/firebase';
import { createDataLayer } from '@cyber-eco/services';

const adapter = new FirebaseStorageAdapter(() => getFirestore());
const dataLayer = createDataLayer(adapter);

// Create a document
await dataLayer.create('users', {
  displayName: 'Jane Doe',
  email: 'jane@example.com',
});

// Query with filters
const admins = await dataLayer.query('users', {
  filters: [{ field: 'role', operator: '==', value: 'admin' }],
});

Full Quickstart Guide

Architecture¶

@cyber-eco/types        (zero runtime deps — pure TypeScript)
       |
       +----------------------+
       |                      |
       v                      v
@cyber-eco/firebase     @cyber-eco/auth
  (peer: firebase)       (peer: firebase, react?, jsonwebtoken?)
       |                      |
       |    +-----------------+
       |    |
       v    v
@cyber-eco/services
  (NO firebase dependency — core architectural constraint)
       |
       v
  apps/hub              (Astro + React islands)

The StorageAdapter pattern decouples all domain logic from any specific database. Today it uses Firebase/Firestore; tomorrow it could use IPFS, a blockchain, or a peer-to-peer mesh — without changing a single line of application code.

Deep Dive: Architecture

Project Status¶

Component	Status	Details
`@cyber-eco/types`	Stable	24 type files, zero runtime deps
`@cyber-eco/firebase`	Stable	16/16 tests passing
`@cyber-eco/auth`	Stable	26 source files, dual entry points
`@cyber-eco/services`	Stable	22 files, zero Firebase imports
Hub App	Stable	122+ source files, Astro + React
MCP Server	Stable	Python/uv, 7 tools
Tokenomics	Draft	CYE token economics
P2P Architecture	Draft	TransportAdapter design