From 657bf0b01395214f2cd6bf6eb35a7bc0cb998d81 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 2 Jun 2025 17:53:35 +0000 Subject: [PATCH 1/2] Initial plan for issue From cb6cd6aab3e60d10c9faf81754e293f0617fc1ce Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 2 Jun 2025 18:00:54 +0000 Subject: [PATCH 2/2] Add mermaid diagrams to README: architecture, dev tools ecosystem, and installation guide Co-authored-by: 0xrinegade <101195284+0xrinegade@users.noreply.github.com> --- README.md | 240 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 240 insertions(+) diff --git a/README.md b/README.md index 90ca994..fd7f9bc 100644 --- a/README.md +++ b/README.md @@ -36,10 +36,190 @@ just dev-tools-check - ✅ **Comprehensive**: From systems programming to AI/ML to blockchain development - ✅ **Production Ready**: Enterprise-grade tools used by top companies +#### Development Tools Ecosystem + +```mermaid +mindmap + root((COSMIC SVM
Dev Tools
2,600+)) + Programming Languages + Core Languages (25+) + Rust, Go, Python + Node.js, Deno, Bun + Zig, Crystal, Swift + Functional + Clojure, Scala, Haskell + Erlang, Elixir + Scientific + Julia, R, MATLAB + IDEs & Editors (15+) + Modern + VS Code, Cursor IDE + Zed IDE + Enterprise + IntelliJ, Eclipse + WebStorm, NetBeans + Terminal + Vim, Emacs, Helix + Web Development (40+) + Frameworks + React, Angular, Vue + Svelte, SolidJS + Build Tools + Vite, Webpack, esbuild + Rollup, Parcel + Styling + Tailwind, Sass, PostCSS + Cloud & Infrastructure (25+) + Multi-Cloud + AWS, Azure, GCP + DigitalOcean, Linode + IaC + Terraform, Pulumi + Ansible, Chef + Containers + Docker, Podman, k8s + Security & Network (30+) + Scanning + Nmap, Nikto, OpenVAS + Penetration Testing + Metasploit, Burp Suite + VPN + WireGuard, Tailscale, Tor + AI/ML & Blockchain + AI Tools + PyTorch, TensorFlow + Ollama, Transformers + Blockchain + Hardhat, Foundry + Solidity, Web3 + Database Systems (20+) + SQL + PostgreSQL, MySQL + NoSQL + MongoDB, Redis, Neo4j + Big Data + Cassandra, InfluxDB + Specialized + Game Dev + Godot, Blender, Unity + Mobile + React Native, Flutter + Scientific + Jupyter, NumPy, SciPy + Media + FFmpeg, OBS, Audacity +``` + For complete documentation, see [docs/DEV-TOOLS.md](docs/DEV-TOOLS.md). --- +## Architecture Overview + +The COSMIC Desktop Environment is built with a modular architecture that separates core libraries, system services, and user applications: + +```mermaid +graph TB + subgraph "COSMIC Libraries & Protocols" + LP[libcosmic] + CP[cosmic-protocols] + CT[cosmic-text] + CTH[cosmic-theme] + CTI[cosmic-time] + end + + subgraph "Core System Services" + CS[cosmic-session] + CC[cosmic-comp
Wayland Compositor] + CSD[cosmic-settings-daemon] + CG[cosmic-greeter
Display Manager] + CN[cosmic-notifications] + CI[cosmic-idle] + XDG[xdg-desktop-portal-cosmic] + end + + subgraph "Desktop Environment" + CPL[cosmic-panel] + CBG[cosmic-bg] + CL[cosmic-launcher] + COSD[cosmic-osd] + CWE[cosmic-workspaces-epoch] + CA[cosmic-applets] + end + + subgraph "User Applications" + CF[cosmic-files] + CE[cosmic-edit] + CTERM[cosmic-term] + CSET[cosmic-settings] + CST[cosmic-store] + CP2[cosmic-player] + CSS[cosmic-screenshot] + CTE[cosmic-theme-editor] + CAL[cosmic-applibrary] + end + + subgraph "External Integration" + PL[pop-launcher] + CR[cosmic-randr] + CICO[cosmic-icons] + end + + %% Dependencies + LP --> CS + LP --> CC + LP --> CSD + LP --> CPL + LP --> CF + LP --> CE + LP --> CTERM + LP --> CSET + LP --> CST + + CP --> CC + CP --> XDG + + CT --> CF + CT --> CE + CT --> CTERM + + CTH --> CPL + CTH --> CBG + CTH --> CTE + + %% System interactions + CS --> CC + CS --> CSD + CS --> CG + CS --> CPL + + CC --> CBG + CC --> CPL + CC --> CL + CC --> COSD + CC --> CWE + + CSD --> CSET + CSD --> CTH + + %% External integrations + PL --> CL + CR --> CSET + CICO --> CPL + CICO --> CF + + classDef library fill:#e1f5fe + classDef service fill:#f3e5f5 + classDef desktop fill:#e8f5e8 + classDef app fill:#fff3e0 + classDef external fill:#fce4ec + + class LP,CP,CT,CTH,CTI library + class CS,CC,CSD,CG,CN,CI,XDG service + class CPL,CBG,CL,COSD,CWE,CA desktop + class CF,CE,CTERM,CSET,CST,CP2,CSS,CTE,CAL app + class PL,CR,CICO external +``` ## Components of COSMIC Desktop * [cosmic-applets](https://github.com/pop-os/cosmic-applets) @@ -317,6 +497,66 @@ We do our best to keep the referenced submodule commits in this repository build Notes on versioning and packaging all these components together properly will be added at a later stage once COSMIC DE gets its first release. +## Installation Guide + +Choose your installation method based on your distribution and needs: + +```mermaid +flowchart TD + Start([Want to install COSMIC?]) --> OS{Which OS?} + + OS -->|Pop!_OS| PopOS[Pop!_OS] + OS -->|Arch Linux| Arch[Arch Linux] + OS -->|Fedora| Fedora[Fedora] + OS -->|NixOS| NixOS[NixOS] + OS -->|openSUSE| SUSE[openSUSE Tumbleweed] + OS -->|Gentoo| Gentoo[Gentoo] + OS -->|Other| Other[Other Distribution] + + PopOS --> PopVer{Which version?} + PopVer -->|24.04 Alpha| Pop24[✅ Recommended
Latest features] + PopVer -->|22.04 LTS| Pop22[⚠️ Legacy
Limited updates] + + Pop24 --> PopInstall[Install from ISO
or upgrade with
pop-upgrade] + Pop22 --> PopLegacy[Enable Wayland
+ Install cosmic-session] + + Arch --> ArchInstall[pacman -S cosmic-session
or pacman -S cosmic] + Fedora --> FedoraInstall[dnf copr enable ryanabx/cosmic-epoch
dnf install cosmic-desktop] + NixOS --> NixInstall[Add to configuration.nix:
services.desktopManager.cosmic.enable = true] + SUSE --> SUSEInstall[opi patterns-cosmic
Select X11:COSMIC:Factory] + Gentoo --> GentooInstall[Add cosmic-overlay
emerge cosmic-meta] + + Other --> BuildChoice{Build from source?} + BuildChoice -->|Yes| BuildSource[Install dependencies
+ git clone --recurse-submodules
+ just sysext] + BuildChoice -->|No| Wait[Wait for your distro
to package COSMIC] + + PopInstall --> Login[Log out → Select COSMIC
at login screen] + PopLegacy --> Login + ArchInstall --> Login + FedoraInstall --> Login + NixInstall --> Login + SUSEInstall --> Login + GentooInstall --> Login + BuildSource --> SystemExt[Move cosmic-sysext to
/var/lib/extensions
+ systemctl enable systemd-sysext] + SystemExt --> Login + + Login --> DevTools{Need dev tools?} + DevTools -->|Yes| InstallTools[just dev-tools
2,600+ tools installed] + DevTools -->|No| Enjoy[🎉 Enjoy COSMIC!] + InstallTools --> CheckTools[just dev-tools-check
Verify installation] + CheckTools --> Enjoy + + classDef recommended fill:#c8e6c9 + classDef warning fill:#ffecb3 + classDef action fill:#e1f5fe + classDef end fill:#f3e5f5 + + class Pop24,PopInstall recommended + class Pop22,PopLegacy warning + class ArchInstall,FedoraInstall,NixInstall,SUSEInstall,GentooInstall,BuildSource,SystemExt,InstallTools,CheckTools action + class Enjoy end +``` + ## Installing on Pop!\_OS COSMIC DE is in its first alpha release. Using and testing the alpha is welcome. Bugs and breakage are expected.