Config files and folder structure

Here we will detail the different folder and config file locations and their purpose.

Folders and general files

The core framework directory, a.k.a. the one you see first on the GitHub web interface, contains the following folders and files:

• .github - For GitHub and git specific data, GitHub actions workflows, issue and PR templates
• Config - The default config folder containing the default config files
  • Core - Contains core configs
  • Translations - Translation configs for the i18n module
• Content - The default content folder, contains example images and icons
• Framework - Contains the entire source code and dependencies for the framework, for more info for framework developers scroll to the bottom of the page
• Projects - Contains your projects
• UVKBuildTool - Contains the UVKBuildTool and its source code
• create-project.sh - Used to create a project
• export.sh - Used to export your application for production distribution
• install.sh - The framework installation script
• update.sh - An automated script to update your project and framework to a new version

Additionally, every project contains those additional files and folders:

• Exported - For storing your final production builds
• Generated - For generated files and sources
• Source - For your application's source code
• CMakeLists.txt - The CMake project file
• uvproj.yaml - Your project's config

Config files

The config files are located under the Config folder, which itself contains 2 directories, Core and Translation.

The Core directory stores the following files:

• DefaultLayout.ini - The layout files for the UI, do not modify directly
• FallbackLayout.ini - The fallback layout for the UI in case your normal file cannot be found, do not modify directly
• Keybindings.yaml - For custom keybindings, detailed in later wiki entries
• Modules.yaml - The modules config file, contains saved settings for different modules, detailed in later entries
• Renderer.yaml - The settings for the renderer, detailed in later entries
• Window.yaml - The settings for the window, detailed in later entries

The Translation folder initially stores just one file, translation-base.yaml. This file defines all strings that can be translated by the localization module. Additionally, you can create additional files using the standard locale naming structure for creating translations. More info can be found in later entries

Directory prefix macros

Check out the Directory strings and Config.hpp page.