Skip to main content

troubleshooting

Common problems people run into building, installing, or running fort.uwp - and how to fix em.

install / sideload issues​

"This app package is not signed with a trusted certificate" or install just fails silently​

fort.uwp is a self signed app - it ships as a sideloaded .msix file with a self-signed cert. You need to install the .cer file before installing the app itself, and it has to go into the right store:

  • Open the .cer → Install Certificate → Local Machine → Trusted People
  • Not Trusted Root Certification Authorities - that's the most common mistake here and it'll silently fail (or refuse) install if you pick it

Easiest fix: just run the included scripts\Install.ps1 as admin saves you time if you dont know what your doing :p

"Sideloading apps is not allowed"​

Developer Mode (or "Sideload apps if on a older bulid of W10") needs to be on: Windows Settings → Update & Security → For developers. Install.ps1 will enable this for you if it's off; Visual Studio should also prompt you the first time you try to deploy.

missing dependency errors (VCLibs, WinUI runtime)​

The app depends on Microsoft.VCLibs.140.00 and the Microsoft.UI.Xaml.2.5 package being present. Install.ps1 checks for both and installs whats missing - if you're installing manually instead, you'll need to grab and install those first (should be found in the same folder as the appx)

sign-in issues​

stuck on the "waiting for browser" screen​

The sign-in flow times out after 5 minutes (see sign-in & accounts) - if your browser session stalls or you close the tab without approving/denying, just cancel and try again from LoginPage.

signed in, but profile info was not updated​

This is expected, not a bug: on launch, the app shows your cached profile immediately and refreshes it from fort.social in the background. If that background refresh fails (offline, or the token was revoked on fort.social's end), the app just keeps showing the last-known cached data rather than signing you out - you won't get logged out automatically, only by explicitly signing out or clearing login info in Settings.

can't edit my profile from the app​

That's intended- ProfilePage is read-only. fort.social is where info for your account is fetched so edits happen there, not in fort.uwp.

build issues​

dotnet build fails or can't find the project type​

This is a legacy-style UAP project, not an SDK-style one - it needs MSBuild with UWP/XAML build targets, which only come with Visual Studio's "Universal Windows Platform development" workload. See building it.

can't deploy/debug to ARM or ARM64​

There's no ARM emulator for a typical x64 dev machine - you'll need an actual ARM/ARM64 device (or a remote machine connection) to deploy and debug those platform.

still stuck?​

Open a GitHub issue! or just contact us directly :)