Welcome to the Bitxenia Docs

This repository contains the official documentation and technical references for the Bitxenia ecosystem — a set of experimental infrastructures, tools, and case studies designed to explore new ways of building resilient, community-owned, and decentralized web applications.

Bitxenia was born from the idea that the Internet should be open, collaborative, and collectively maintained.
Our work combines research and implementation to evaluate how modern peer-to-peer technologies can replace traditional centralized cloud infrastructures, enabling communities to host and evolve their own software.

Here you’ll find detailed explanations of how we designed, built, and deployed different peer-to-peer infrastructures, focusing on two major technological ecosystems:

• IPFS and its related protocols (IPFS Cluster, IPNS, libp2p), along with higher-level frameworks such as OrbitDB, used to build decentralized file systems and application layers.
• Blockchain / Ethereum, used to explore smart contracts, decentralized storage (Swarm), and name resolution (ENS).

What you’ll find here

The documentation is organized into sections, following a logical path from conceptual foundations to practical implementation details:

• Introduction
  Overview of the motivation, goals, and principles behind Bitxenia.

• IPFS Ecosystem

  • Deployment Infrastructure
    How we host and replicate applications using IPFS Cluster, IPNS, and ENS.
  • Application Infrastructure (AstraDB)
    How we use OrbitDB and libp2p to manage distributed state and data.

• Blockchain Ecosystem

  • Swarm
    Decentralized storage over Ethereum.
  • Ethereum
    Smart contracts and naming services that complement IPFS-based systems.

• User Interfaces
  How decentralized backends connect to accessible and user-friendly front-end layers.

Research Background

This documentation originates from a research project developed as part of the academic work behind Bitxenia.
The project explores alternative infrastructures for the development and deployment of community-based, distributed, and decentralized applications, focusing on how peer-to-peer technologies can serve as the foundation for community-managed services.

The complete findings, methodologies, and evaluations are detailed in the final report:

📄 Final Report (Spanish PDF)
Ecosystem Analysis for the Implementation of Platform-as-a-Service Architectures for Community, Distributed, and Decentralized Applications

“Análisis de ecosistemas para la implementación de plataformas como servicio para despliegue de aplicaciones comunitarias, distribuidas y descentralizadas.”

The report — written in Spanish — includes an in-depth analysis of existing decentralized ecosystems (such as IPFS, Ethereum, and Swarm), a comparison between them, and multiple experimental implementations.
This documentation expands upon that research, organizing its practical components, technical setups, and case studies in a structured format for continued exploration and collaboration.