The Adaptive Filesystem
Description
Having trouble packaging or working with various filesystem hierarchy layouts simultaneously, especially when dealing with BSD, Linux, Windows, and MacOS? Are you looking for an adaptive filesystem that fits into all of them, simplifying your software product with a single layout? This is the right research repository.
At (Holloway) Chew, Kean Ho's The Adaptive Filesystem Research Project, tech volunteers are continuously updating the repository's datasets and abstracting the three vital layouts:
Common- the common structure used everywhere, including operating systems, project repositories, and package designs.Root- the operating system filesystem hierarchy.User- the user directory layout.
The research goals are simple:
- Maximizing Compatibilities, Minimizing Conflicts - analyzes and abstracts various standards for common patterns. Through these patterns, a new layout is defined, maximizing inter-compatibilities and minimizing conflicts across multiple operating systems; AND
- Unifying Filesystems - with a single adaptive filesystem, packaging software and distributing it to end-users is simplified and unified, making maintenance, automation, documentation, and communications seamless; AND
- Solid and Hygienic Design References - with an adaptive filesystem, this repository becomes a lighthouse for designing any project layout structures, architecting operating system directory layouts, and defining a simplified and secure packaging system.
This repository is 100% deterministic with futuristic directive consequences. It is 100% human-made, and generative artificial intelligence (AI) contributions (e.g., vibe coding) ARE STRICTLY PROHIBITED. AI is ONLY USED for static analysis and writing grammar corrections.
Remember, THIS REPOSITORY IS A DESIGN REFERENCE, NOT RELIGIOUS RULES. In other words, they are OPINIONS.
Caution
DO NOT ATTEMPT TO RELIGIOUSLY ENFORCE your project layout based on this repository. IN NO WAY does this project force anyone to strictly adhere to these as rules.
Fanaticism destroys. Please act responsibly and sensibly. Adapt and reference.
The adaptive filesystem currently studies the following operating systems for its unification:
- Apple's
iOS - Apple's
MacOS - FreeBSD
Linux-based OSes- Microsoft
Windows - MVC|MVP Project Architectures
- MVVM Project Architectures
- VIPER Project Architectures
Important
For Linux-based OSes, this is the consolidated version of all its major distributions including but not limited to SystemD, FreeDesktop.org, Red Hat Linux, Debian, Devuan, Void Linux, Fedora, etc.
To use this dataset, first set up the markdown rendering git repository server, for example:
https://github.com/ChewKeanHo/research-the-adaptive-filesystem
Then, you can browse each directory and read its README.md documentation describing its roles and responsibilities.
You can also use a UNIX program like tree to easily map out a directory hierarchy. The command is:
$ tree -a -d path/to/TARGET/
Notes (English)
Files
research-the-adaptive-filesystem-2.0.0.zip
Files
(7.8 MB)
| Name | Size | Download all |
|---|---|---|
|
md5:0c218dd52da829dc648e35449c375c85
|
6.9 MB | Preview Download |
|
md5:0476bf7072a4e78a7c399c1245bb2eb2
|
924.5 kB | Preview Download |
Additional details
Identifiers
- URL
- https://github.com/ChewKeanHo/researches-filesystems-hierarchy
- DOI
- 10.5281/zenodo.17864564
- Other
- 3113F0A2-61BD-449C-BC0F-DE4C09997AC6
- Other
- chewkeanho-research-the-adaptive-filesystem
Dates
- Created
-
2025-12-09Initialized Project
- Updated
-
2025-12-09v1.0.0
- Updated
-
2026-06-08v2.0.0
Software
- Repository URL
- https://github.com/ChewKeanHo/research-the-adaptive-filesystem
- Development Status
- Active
References
- FREEBSD; 2025; "3.5. Directory Structure"; FreeBSD Handbook; 4th Edition; The FreeBSD Project via The FreeBSD Community & The FreeBSD Foundations; Viewed 2025-12-09; Available at: https://docs.freebsd.org/en/books/handbook/basics/#dirstructure
- SOFTWARE FREEDOM CONSERVANCY; 2025; "file-hierarchy — File system hierarchy overview"; FreeDesktop via Software Freedom Conservancy; Viewed 2025-12-09; Available at: https://www.freedesktop.org/software/systemd/man/latest/file-hierarchy.html
- FREEDESKTOP FILESYSTEM HIERARCHY STANDARD PROJECT CONTRIBUTORS, THE LINUX FOUNDATION, DANIEL QUINLAN, PAUL 'RUSTY' RUSSELL, CHRISTOPHER YEOH; 2025; "Filesystem Hierarchy Standard"; FreeDesktop via Software Freedom Conservancy; Viewed 2025-12-09; Available at: https://specifications.freedesktop.org/fhs/latest/rootFilesystem.html
- GOHUGO PROJECT AUTHORS; 2025; "Directory Structure"; The GoHugo Team; Viewed 2025-12-09; Available at: https://gohugo.io/getting-started/directory-structure/
- PALEBLOODSKY; 2025; "Filesystems"; OpenWRT.org; Viewed 2025-12-09; Available at: https://openwrt.org/docs/guide-user/storage/filesystems-and-partitions
- BXBZQ, CATH O'DERAY, KPEDERSEN; 2021; "What's the proper way to install truetype fonts"; The FreeBSD Forum; The FreeBSD Foundation via XenForo Ltd; Viewed 2025-12-09; Available at: https://forums.freebsd.org/threads/whats-the-proper-way-to-install-truetype-fonts.79999/
- GRAHAM PERRIN; DAVID EDMUNDSON; 2024; "Bug 442976"; bugs.kde.org; KDE.org; Viewed 2025-12-09; Available at: https://bugs.kde.org/show_bug.cgi?id=442976
- JOE BROCKMEIER; 2025; "Debian Technical Committee overrides systemd change"; Articles; lwn.net via Eklektix, Inc.; Viewed 2025-12-09; Available at: https://lwn.net/Articles/1041316/
- RFC1036 AUTHORS; 2025; "/var/lock/ is the standard interface for locks of serial devices"; GitHub via GitHub.Inc; Viewed 2025-12-09; Available at: systemd/systemd#38563
- DEVUAN; 2025; "Welcome to Devuan"; Devuan.org; Viewed 2025-12-09; Available at: https://www.devuan.org/
- VOID LINUX CONTRIBUTORS AND JUAN RP; 2025; "The Void (Linux) distribution"; VoidLinux.org; Viewed 2025-12-09; Available at: https://docs.voidlinux.org/about/index.html
- SYSTEMD; 2025; "The Case for the /usr Merge"; SystemD.org; Viewed 2025-12-09; Available at: https://systemd.io/THE_CASE_FOR_THE_USR_MERGE/
- ORACLE; 2012; "User Environment Feature Changes"; Oracle Solaris 11 Information Library; Oracle and/or its affiliates; Viewed 2025-12-09; Available at: https://docs.oracle.com/cd/E23824_01/html/E24456/userenv-1.html
- DEBIAN; 2025; "UsrMerge - The Debian /usr Merge"; Wiki; Debian.org; Viewed 2025-12-09; Available at: https://wiki.debian.org/UsrMerge
- RED HAT; 2025; "Changes/Unify bin and sbin"; Wiki; FedoraProject.org via Red Hat Inc. and others; Viewed 2025-12-09; Available at: https://fedoraproject.org/wiki/Changes/Unify_bin_and_sbin
- FLATPAK TEAM; 2025; "Introduction to Flatpak"; Documentations; Flatpak Team via @pradyunsg's Furo; Viewed 2025-12-09; Available at: https://docs.flatpak.org/en/latest/introduction.html
- RED HAT; 2025; "Chapter 2. File System Structure and Maintenance"; Red Hat Enterprise Linux > 7 > Storage Administration Guide; Viewed 2025-12-09; Available at: https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/7/html/storage_administration_guide/ch-filesystem
- THE LINUX USERSPACE API GROUP; 2025; "UAPI.9 Linux File System Hierarchy#"; UAPI Group Specifications; Version 0.1; The Linux Userspace API Group; Viewed 2025-12-09; Available at: https://uapi-group.org/specifications/specs/linux_file_system_hierarchy/
- FREEBSD; 2025; "hier - Miscellaneous Information Manual"; FreeBSD Manual Pages; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://man.freebsd.org/cgi/man.cgi?hier(7)
- FREEBSD; 2025; "Ports - Miscellaneous Information Manual"; FreeBSD Manual Pages; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://man.freebsd.org/cgi/man.cgi?query=ports&sektion=7&apropos=0&manpath=FreeBSD+15.0-RELEASE+and+Ports
- FREEBSD; 2025; "Chapter 4. Installing Applications: Packages and Ports"; FreeBSD Handbook; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://docs.freebsd.org/en/books/handbook/ports/
- FREEBSD; 2025; "FreeBSD Porter's Handbook"; FreeBSD Handbook; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://docs.freebsd.org/en/books/porters-handbook/book/
- FREEBSD; 2025; "yp - System Manager's Manual"; FreeBSD Manual Pages; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://man.freebsd.org/cgi/man.cgi?query=yp&manpath=FreeBSD+13.2-STABLE
- FREEBSD; 2025; "named - Internet domain name server"; FreeBSD Manual Pages; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-09; Available at: https://man.freebsd.org/cgi/man.cgi?query=named&sektion=8&manpath=OpenBSD+5.1
- APPLE; 2017; "Bundle Structures"; Documentation Archive - Bundle Programming Guide; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-04-30; Available at: https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html
- APPLE; 2018; "File System Basics"; Documentation Archive - Bundle Programming Guide; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-04-30; Available at: https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/FileSystemOverview/FileSystemOverview.html
- DAVID NEDROW; 2025; "Leveraging a User Applications Folder on macOS"; GitHub's Gists; GitHub via GitHub.Inc; Viewed 2026-05-19; Available at: https://gist.github.com/dnedrow/e96944ad8bf5ea199a226345e696b33b
- APPLE; 2026; "Article - Placing content in a bundle"; Bundle Resources; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-05-19; Available at: https://developer.apple.com/documentation/BundleResources/placing-content-in-a-bundle
- APPLE; 2026; "Bundles and Frameworks"; Xcode; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-05-19; Available at: https://developer.apple.com/documentation/xcode/bundles-and-frameworks
- APPLE; 2026; "Framework Integration - Creating a watchOS app"; SwiftUI Tutorials; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-05-20; Available at: https://developer.apple.com/tutorials/swiftui/creating-a-watchos-app
- APPLE; 2026; "Article - Creating an App Clip with Xcode"; App Clips; Apple Developer; Apple Inc.; Cupertino, California, United States of America; Viewed on 2026-05-20; Available at: https://developer.apple.com/documentation/AppClip/creating-an-app-clip-with-xcode
- FREEBSD; 2025; "hier - Miscellaneous Information Manual"; FreeBSD Manual Pages; The FreeBSD Project via The FreeBSD Community and The FreeBSD Foundation; Viewed 2025-12-20; Available at: https://man.freebsd.org/cgi/man.cgi?query=hier&manpath=FreeBSD+16.0-CURRENT
- MICROSOFT; 2026; "Recognized environment variables"; Windows - Deployment; Microsoft Corporation; Washington, United States of America; Viewed on 2026-05-31; Available at: https://learn.microsoft.com/en-us/windows/deployment/usmt/usmt-recognized-environment-variables
- TRYGVE M. H. REENSKAUG; 1978; "MVC"; XEROX PARC 1978-79; University of Oslo; Norway; Viewed on 2026-05-31; Available at: https://folk.universitetetioslo.no/trygver/index.html
- ROBERT C. MARTIN; 2011; "Clean Architecture"; The Clean Code Blog; The Clean Coder Blog via cleancoder.com; World Wide Web; Viewed on 2026-05-31; Available at: https://blog.cleancoder.com/uncle-bob/2011/11/22/Clean-Architecture.html
- STRONGSELF FOUNDATION; 2017; "Introduction to VIPER"; The Book of VIPER; StrongSelf Foundation via GitHub and GitHub.Inc; Viewed on 2026-05-31; Available at: https://github.com/strongself/The-Book-of-VIPER/blob/master/english/introduction-to-viper.md
- MARIO FUKSA; SANDRO SPETH; STEFFEN BECKER; 2025; "MVVM Revisited: Exploring Design Variants of the Model-View-ViewModel Pattern"; arXiv: 2504.18191v1; Cornell University; Ithaca, New York, United States of America; Viewed on 2026-05-31; Available at: https://arxiv.org/html/2504.18191v1