# bebasid/bebasdns architecture

> Architecture diagram of the GitHub repository bebasid/bebasdns, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bebasid/bebasdns
- Repository: https://github.com/bebasid/bebasdns

## Overview

BebasDNS is a public DNS service offered in filtering variants, alongside DoH/DoT configuration profiles and filtering-list data. The documented user journey is to choose a variant and configure a device to use the DNS service. The README excerpt and file tree do not show resolver implementation or how lists are consumed, so those internal relationships are omitted.

Main entry points: [`dev/resources/config/doh_ios-macos`](https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/doh_ios-macos) (DoH profiles), [`dev/resources/config/dot_ios-macos`](https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/dot_ios-macos) (DoT profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_service["DNS service"]
  node_resolver["BebasDNS resolver"]
  node_variants["DNS variants"]
end

subgraph group_profiles["Device profiles"]
  node_doh["DoH profiles"]
  node_dot["DoT profiles"]
end

subgraph group_data["Filtering data"]
  node_hosts["Host filters"]
  node_unbound["Unbound lists"]
end

node_user(("DNS user"))

node_user -->|"chooses variant"| node_variants
node_user -.->|"configures device"| node_doh
node_user -.->|"configures device"| node_dot
node_user -.->|"sends DNS queries"| node_resolver

click node_doh "https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/doh_ios-macos"
click node_dot "https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/dot_ios-macos"
click node_hosts "https://github.com/bebasid/bebasdns/tree/main/dev/resources/hosts"
click node_unbound "https://github.com/bebasid/bebasdns/tree/main/dev/resources/unbound"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_resolver,node_variants,node_user toneBlue
class node_doh,node_dot toneAmber
class node_hosts,node_unbound toneMint
```

## Components

### DNS service

- **BebasDNS resolver**
- **DNS variants**

### Device profiles

- [DoH profiles](https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/doh_ios-macos): `dev/resources/config/doh_ios-macos`
- [DoT profiles](https://github.com/bebasid/bebasdns/tree/main/dev/resources/config/dot_ios-macos): `dev/resources/config/dot_ios-macos`

### Filtering data

- [Host filters](https://github.com/bebasid/bebasdns/tree/main/dev/resources/hosts): `dev/resources/hosts`
- [Unbound lists](https://github.com/bebasid/bebasdns/tree/main/dev/resources/unbound): `dev/resources/unbound`

### Other components

- **DNS user**

## Connections

- DNS user → DNS variants: chooses variant (evidence: `README.md`)
- DNS user → DoH profiles: configures device
- DNS user → DoT profiles: configures device
- DNS user → BebasDNS resolver: sends DNS queries
