Skip to content

Instantly share code, notes, and snippets.

@decagondev
Created June 3, 2026 21:49
Show Gist options
  • Select an option

  • Save decagondev/93670df73d2d2cc8bf9d7b1274cbfa01 to your computer and use it in GitHub Desktop.

Select an option

Save decagondev/93670df73d2d2cc8bf9d7b1274cbfa01 to your computer and use it in GitHub Desktop.

ARCHITECTURAL BLUEPRINT: DECLARATIVE SPATIAL WORKSPACE

Document ID: SPEC-2026-NIX-SPATIAL
Classification: Proprietary / Internal Corporate R&D
Target Platform: NixOS / Wayland (Hyprland Compositor)
Hardware Specification: ASUS AirVision M1 + Custom PA-CF Wireless Loop


1. SYSTEM EXECUTIVE SUMMARY

This document establishes the official engineering framework for a zero-intervention, wire-free, multi-window spatial development cockpit. The design architecture completely eradicates trailing cords and hanging cable snags below the shoulder line, allowing software engineers to maintain a 60% real-world optical pass-through rate to their physical surroundings.

By mapping a declarative system layer through NixOS and handling window sharding through Hyprland, the entire workstation configuration behaves as plain, immutable code. This ensures 100% reproducible deployment speeds across an expanding enterprise fleet of developer laptops.


2. BILL OF MATERIALS (BOM)

Part ID Component Name Functional Role Qty Est. Unit Cost Procurement Source
HW-01 ASUS AirVision M1 Micro-OLED Translucent Smart Display Glasses (87g, 60% Transparency) 1 £329.99 ASUS B2B / UK Commercial Channel
HW-02 AIMIBO Wireless HDMI RX/TX Kit 5GHz Millimeter-Wave Zero-Lag (<10ms) Video Bridge with Onboard 5000mAh Power Cell 1 £159.99 Amazon Business UK / Direct
HW-03 JSADZKJ 90° Type-C FPC Ultra-thin Flexible Printed Circuit Flat Ribbon Extension Line (Right-Angled Connector) 1 £11.99 Specialized Component Distributor
HW-04 Mechanical Shirt Clips Lavalier-style high-tension clothing clips for wire strain containment 2 £2.50 General Electronics Supply
MAT-01 Polyamide Carbon Fibre (PA-CF) High-tensile, thermal-insulated structural engineering filament As req. Internal Maker Office Inventory

3. PHYSICAL FABRICATION & MANUFACTURING PLAN

3.1 Material Processing & Slicing Profiles

  • Filament Conditioning: Polyamide Carbon Fibre (PA-CF). The raw filament spool must be oven-baked at 80°C for a minimum of 6 continuous hours prior to print initialization to eliminate microscopic ambient moisture pockets.
  • Slicer Dimensional Compensation: Apply a global structural scaling compensation variable of +0.75% inside your slicing engine. This explicitly counters the material's cooling shrinkage rate, ensuring a tight friction-snap mount onto the ASUS glasses frame without scuffing the factory plastic.
  • Layer Resolution & Fill: Program layer height to 0.16mm with an absolute 100% infill density configured to a gyroid matrix. This ensures high structural compliance and torsional elasticity along the temple joints.

3.2 Component Mechanical Architecture

  1. The Structural Raceway Sleeve (Left Arm): Manufacture a thin, rigid C-shaped clip structured to follow the exact physical taper of the left temple arm of the ASUS M1 glasses. The interior guide cavity must be rounded and smooth to secure the paper-thin FPC ribbon cable flat against the frame.
  2. The Strain-Relief Collar: Integrate a flared retention block at the rear tip of the sleeve. The flat FPC ribbon must terminate inside a magnetic breakaway USB-C housing embedded into this collar, isolating the glasses' internal ports from external tugs or drops.
  3. The Pocket Node Enclosure: Fabricate a smartphone-sized pocket housing to shield the AIMIBO wireless receiver PCB and the 5000mAh power cell. Print a rigid internal divider to thermally isolate the battery from the operational heat generated by the 5GHz transmitter module. Build a geometric honeycomb ventilation matrix on the outer casing to facilitate passive cooling.

4. DECLARATIVE NIXOS OPERATIONAL SPECIFICATION

Following SOLID modular software design, the deployment configuration is decoupled into explicit modules separating core hardware overrides, window compositor behaviors, and developer tool layers.

4.1 Modular Hardware Interface: hardware-spatial.nix

This component isolates low-level lid configuration variables, forcing the laptop CPU to continue processing code at maximum velocity while resting closed inside a secure desk space or storage locker.

# modules/hardware-spatial.nix
{ config, pkgs, ... }:

{
  # SOLID: Single Responsibility - Absolute abstraction of power & lid handling mechanics
  services.logind = {
    extraConfig = ''
      HandleLidSwitch=ignore
      HandleLidSwitchExternalPower=ignore
      HandleLidSwitchDocked=ignore
    '';
  };

  # Direct hardware optimization for Wayland compositing engines
  hardware.graphics = {
    enable = true;
    enable32Bit = true;
  };
}

4.2 Modular Compositor Mapping: hyprland-spatial.nix

This component declaration watches Wayland hotplug outputs. The second the wireless millimeter-wave link boots up, the script automatically blanks out the internal screen for privacy and throws an optimized programming canvas across the glasses.

# modules/hyprland-spatial.nix
{ config, pkgs, ... }:

{
  programs.hyprland = {
    enable = true;
    xwayland.enable = true;
  };

  # Bind the declarative configurations straight to the user's home manager layer
  home-manager.users.developer.xdg.configFile."hypr/hyprland.conf".text = ''
    # =========================================================================
    # HYPRLAND DECLARATIVE SPATIAL WORKSPACE LAYER
    # =========================================================================

    # 1. HARDWARE OUTPUT ROUTING
    # Terminate internal laptop display output and scale the 100" spatial canvas
    monitor = eDP-1, disable
    monitor = HDMI-A-1, 1920x1080@60, 0x0, 1

    # 2. CORE SYSTEM BASE INPUTS
    env = XDG_CURRENT_DESKTOP, Hyprland
    env = XDG_SESSION_TYPE, wayland

    # 3. AUTOMATED DEPLOYMENT GRID PROFILE (SOLID Interface Segregation)
    # Focal Zone (Center 60% Width) - Primary Code Workspace Editor / IDE
    windowrulev2 = move 20% 0, class:(main-ide)
    windowrulev2 = size 60% 100%, class:(main-ide)
    windowrulev2 = focus, class:(main-ide)

    # Right Screen Shard (20% Width) - Claude Max & Codex Pro Core CLI Daemons
    windowrulev2 = move 80% 0, class:(kit-ai-terminal)
    windowrulev2 = size 20% 100%, class:(kit-ai-terminal)

    # Left Screen Shard (20% Width) - Active Code Repository Tree / Documentation
    windowrulev2 = move 0 0, class:(system-tree)
    windowrulev2 = size 20% 100%, class:(system-tree)
    
    # Visual Polish for maximum spatial screen real-estate
    windowrulev2 = noborder, class:(.*)
    windowrulev2 = rounding 0, class:(.*)
  '';
}

4.3 Modular AI Application Layer: ai-terminal.nix

This module governs the background toolchains and alias hooks required to invoke your dual-agent workflows instantly across the targeted canvas partitions.

# modules/ai-terminal.nix
{ config, pkgs, ... }:

{
  environment.systemPackages = with pkgs; [
    nodejs
    python311
    git
    foot # Ultra-fast, lightweight Wayland terminal emulator
  ];

  # Declarative initialization aliases to cleanly force windows into their spatial classes
  environment.interactiveShellInit = ''
    alias start-dev-canvas='foot --class=main-ide nvim'
    alias start-ai-agents='foot --class=kit-ai-terminal -e bash -c "echo === CLAUDE MAX & CODEX PRO CORE === && bash"'
    alias start-tree-view='foot --class=system-tree -e ranger'
  '';
}

5. FLEET-WIDE ENTERPRISE ROLLOUT PLAN

To deploy this setup to your work laptops instantly, wrap your sub-modules into a standardized Nix Flake. This decouples your core configurations from individual machine variants, achieving absolute immutability.

# flake.nix
{
  description = "Enterprise Declarative Spatial Development Fleet Infrastructure";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    home-manager.inputs.nixpkgs.follows = "nixpkgs";
  };

  outputs = { self, nixpkgs, home-manager, ... }@inputs: {
    # Replace 'corporate-dev-node' with your corporate machine naming convention
    nixosConfigurations.corporate-dev-node = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        ./configuration.nix # The machine's core filesystem baseline
        
        # Modular Spatial Integration Architecture Injection
        ./modules/hardware-spatial.nix
        ./modules/hyprland-spatial.nix
        ./modules/ai-terminal.nix
        
        home-manager.nixosModules.home-manager
      ];
    };
  };
}

5.1 Deployment Routine

  1. Clone the fleet repository into the targeted developer laptop.
  2. Encrypt your master corporate Claude Max and Codex Pro API access credentials directly within your repo using sops-nix to avoid plain-text token leaks.
  3. Rebuild the machine node using the flake layer:
    sudo nixos-rebuild switch --flake .#corporate-dev-node
  4. Put on the custom-fitted PA-CF glasses frame, engage the magnetic breakaway collar into the pocket module, and watch your workspace automatically map in mid-air.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment