cmake
cmake_minimum_required(VERSION 3.16)
project(UltraCanvas VERSION 1.2.0)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# Find required packages
find_package(PkgConfig REQUIRED)
# Graphics libraries
find_package(OpenGL REQUIRED)
find_package(Vulkan REQUIRED)
find_package(glfw3 REQUIRED)
# Image processing
find_package(PNG REQUIRED)
find_package(JPEG REQUIRED)
pkg_check_modules(STB REQUIRED stb)
# Multimedia libraries
pkg_check_modules(VPX REQUIRED vpx)
pkg_check_modules(VORBIS REQUIRED vorbis)
pkg_check_modules(OPUS REQUIRED opus)
find_package(FLAC REQUIRED)
# Font libraries
find_package(Freetype REQUIRED)
pkg_check_modules(HARFBUZZ REQUIRED harfbuzz)
find_package(ICU REQUIRED COMPONENTS uc i18n)
# Platform-specific libraries
if(UNIX AND NOT APPLE)
find_package(X11 REQUIRED)
pkg_check_modules(WAYLAND wayland-client)
endif()
# Header-only libraries via FetchContent
include(FetchContent)
FetchContent_Declare(
 stb
 GIT_REPOSITORY https://github.com/nothings/stb.git
 GIT_TAG master
)
 Dependency Maintenance Checklist
When Adding New Dependencies:
Research License Compatibility: Ensure license is compatible with UltraCanvas
Update This Document: Add entry to appropriate section with all details
Update CMakeLists.txt: Add find_package or FetchContent declarations
Update Installation Scripts: Add to package manager installation commands
Document Version Requirements: Specify minimum supported versions
Test Cross-Platform: Verify dependency works on Windows, Linux, macOS
Update CI/CD: Modify build scripts to include new dependency
Update README: Add installation instructions for end users
Regular Maintenance Tasks:
Monthly: Check for security updates in dependencies
Quarterly: Review and update minimum version requirements
Before Releases: Verify all dependencies are available and up-to-date
Documentation: Keep installation commands current with latest package names
 Known Issues & Workarounds
Common Installation Problems
STB Libraries on Ubuntu < 20.04:
• Issue: Package libstb-dev not available
• Workaround: Manual header installation or use FetchContent
HarfBuzz Version Conflicts:
• Issue: System HarfBuzz too old for advanced features
• Workaround: Use vcpkg or build from source
Vulkan SDK on Older Systems:
FetchContent_Declare(
 nlohmann_json
 GIT_REPOSITORY https://github.com/nlohmann/json.git
 GIT_TAG v3.11.2
)
FetchContent_MakeAvailable(stb nlohmann_json)