Architecture

Overview

flowchart TB
    subgraph Clojure["Clojure Application"]
        Game["Game Code<br/>(examples/*.clj)"]
        Bindings["Raylib Bindings<br/>(raylib/*.clj)"]
        Structs["Struct Definitions<br/>(raylib/structs.clj)"]
    end
    
    subgraph FFI["Foreign Function Interface"]
        Coffi["coffi library"]
        Panama["JDK 22+ Panama API"]
    end
    
    subgraph Native["Native Libraries"]
        Raylib["Raylib C Library<br/>(libs/*)"]
        OpenGL["OpenGL"]
    end
    
    Game --> Bindings
    Bindings --> Structs
    Bindings --> Coffi
    Coffi --> Panama
    Panama --> Raylib
    Raylib --> OpenGL
    
    style Clojure fill:#4B8BBE,color:#fff
    style FFI fill:#FFD43B,color:#000
    style Native fill:#306998,color:#fff

Game Loop Architecture

flowchart LR
    subgraph GameLoop["Main Game Loop"]
        direction TB
        Init["Initialize<br/>Window & State"]
        Tick["Tick/Update<br/>Game Logic"]
        Draw["Draw<br/>Render Frame"]
        Check{"Window<br/>Closed?"}
        Cleanup["Cleanup<br/>Resources"]
    end
    
    Init --> Tick
    Tick --> Draw
    Draw --> Check
    Check -->|No| Tick
    Check -->|Yes| Cleanup
    
    subgraph State["Game State (Atom)"]
        Ship["Ship Position/Velocity"]
        Entities["Asteroids/Bullets"]
        Screen["Screen State"]
    end
    
    Tick -.->|Read/Update| State
    Draw -.->|Read| State

Module layout

src/raylib/ — FFI bindings (this is the library) - core.clj — loads the native library; every binding namespace requires this first - structs.clj — C struct definitions via defalias (Color, Vector2, Vector3, Vector4, Texture, RenderTexture, Rectangle) - colors.clj — color constants (raywhite, red, etc.) - enums.clj — keyboard/mouse enums - internals.clj — internal helpers (ubyte, bool types) - utils.clj — utility functions (random, fade, etc.) - audio.clj — audio functions (Music, Sound) - lights.clj — shader-lighting helpers, based on raylib's rlights.h - nrepl.clj — embedded nREPL server startup, powers the port 7888 live-development workflow - core/ — window, drawing, keyboard, mouse, timing, camera2d, camera3d, collision, gamepad, gestures, shaders - window.clj — window management - drawing.clj — drawing primitives - keyboard.clj — keyboard input - mouse.clj — mouse input - timing.clj — frame timing (FPS, delta time) - camera2d.clj — 2D camera - camera3d.clj — 3D camera and rendering - collision.clj — ray casting and collision detection - gamepad.clj — gamepad input - gestures.clj — touch gesture detection - shaders.clj — shader loading and management - text/, shapes/, textures/ — drawing/loading helpers
src/examples/ — the 78 example namespaces (54 top-level + 3 in games/ + 21 in models/)
src/debug_stats.clj — F1 overlay plugin (see Example Architecture Patterns for usage)
src/raylib_ext.clj — extended/derived bindings not in core raylib
libs/ — bundled native libraries per platform

Project structure diagram

flowchart TB
    subgraph src["src/"]
        subgraph raylib["raylib/ - FFI Bindings"]
            core["core.clj - Library loading"]
            structs["structs.clj - C struct definitions"]
            colors["colors.clj - Color constants"]
            enums["enums.clj - Keyboard/mouse enums"]
            
            subgraph coremod["core/"]
                window["window.clj"]
                drawing["drawing.clj"]
                keyboard["keyboard.clj"]
                mouse["mouse.clj"]
                timing["timing.clj"]
            end
        end
        
        subgraph examples["examples/ - Game Examples"]
            hello["hello_world.clj"]
            pongex["pong.clj"]
            astex["asteroids.clj"]
            tetex["tetris.clj"]
            vampex["vampire_survivors.clj"]
        end
        
        debug["debug_stats.clj - FPS/Memory overlay"]
        raylibext["raylib_ext.clj - Extended bindings"]
    end
    
    subgraph libs["libs/ - Native Libraries"]
        macos["macos/"]
        linux["linux_amd64/"]
        win["win64_msvc16/"]
    end

Bundled libraries

This project includes pre-built Raylib 5.5.0 libraries for different platforms:

Platform	Directory	Library
macOS (Intel/ARM)	`libs/macos`	`libraylib.5.5.0.dylib`
Linux 64-bit	`libs/linux_amd64`	`libraylib.so.5.5.0`
Linux 32-bit	`libs/linux_i386`	`libraylib.a`
Windows 64-bit	`libs/win64_msvc16`	`raylib.dll`
Windows 32-bit	`libs/win32_msvc16`	`raylib.dll`

The correct library is loaded automatically based on your operating system.

macOS code signing

On macOS, you might see a security warning about the library. Fix it with:

bb macos:sign-lib

Or manually:

codesign --force --sign - libs/macos/libraylib.5.5.0.dylib