Momentum-Apps/README.md

Xtreme-Apps

Bundle of external apps tweaked for Xtreme

Why?

Apps we use for Xtreme are all modified (some lots more than others). This includes:

• Removing duplicate icons that are part of firmware to support our Asset Packs system
• Removing duplicate keyboard implementations to use our extended system keyboard
• With our system keyboard also support our CLI command input keyboard to type with PC keyboard
• Moving location of save files or changing how they are saved
• Changing application display names to fit our scheme
• Changing how some menus work/look or adding new exclusive menus and features
• Improving or extending functionality and better integrating with Xtreme firmware
• Updating and fixing apps that were abandoned by the original developers

How?

Apps made by the Xtreme team are kept as plain code here. For all others we use git subtrees to pull updates from elsewhere but also keep our own tweaks. We didn't want to have fork repos for each single app since it would get out of hand very quick. Instead, we opted for subtrees.

Subtrees work in a very peculiar way, where they pull and compare commit history from a remote repo and apply it to a subdirectory of this repo. That's why the commit history for our repo is so huge, it contains all the commits for all the apps, plus our edits.

To make updating more manageable, we have added another layer on top of subtrees:

• each remote app/repo has a .gitremote file that indicates the remote url and branch name
• we have a git alias update-subtree for pulling updates based on the current directory (set it up by running git config --local include.path ../.gitconfig)
• run git update-subtree in each subtree folder to update it
• or run find . -name .gitremote -execdir git update-subtree \; to run it on all subtrees