“GitHub Pages 404 for .well-known/stellar.toml even though file is in main branch”

[NTKleme]

Select Topic Area

Question

Body

Hello,

I’m trying to host a Stellar TOML file for my token project so Pi Wallet can fetch metadata and display the logo/description. My logo (airlie.png) is served correctly from GitHub Pages, but the TOML file always returns a 404 error.

Repo link: https://github.com/NTKleme/airlie-token-assets

Expected TOML URL:
https://ntkleme.github.io/airlie-token-assets/.well-known/stellar.toml

Current situation:
Repo is Public.
File stellar.toml is inside .well-known/ on the main branch.
GitHub Pages is enabled and says the site is live at:
https://ntkleme.github.io/airlie-token-assets/

The logo loads fine at:
https://ntkleme.github.io/airlie-token-assets/airlie.png
But the TOML URL above always returns 404.

What I’ve checked:
Pages is set to deploy from main / root.
Waited several minutes after deployment.

Questions:

Why is GitHub Pages serving airlie.png but not .well-known/stellar.toml?
Is there a special requirement for .well-known folders on GitHub Pages?
Do I need to adjust branch settings or repo structure to make TOML accessible?

Goal: I need a working HTTPS URL (no blob/) so Pi Wallet can fetch the TOML from my Issuer Wallet’s home_domain.

Any guidance on fixing the Pages setup or confirming the correct way to serve .well-known/stellar.toml would be hugely appreciated!

Thanks in advance 🙏

[ghost]

Your TOML 404s because GitHub Pages is running Jekyll and Jekyll ignores dot foldersJust add a file called .nojekyll in the root of your repo and pushThis makes Pages serve .well-known normallyAfter that your TOML should load fine

[NTKleme]

It worked perfectly. Thanks for the help!

[ghost]

Nice!!!! you can mark it as answer it will help others too

[tspascoal]

The accepted answer is correct when using the classic source.

A simpler and more modern would be to change the source to GitHub Pages from source branch and then use HTML static site option.

See more about publishing source in the docs