Boundless ships with no content sources built in. A fresh install has an empty Library, an empty Browse tab, and nothing to search. That is the design, not a missing step: the app is a reader, and you decide what it reads. This page explains the two pieces involved, repositories and sources, and how to set them up.
Repositories and sources
- A repository is a URL that lists sources you can install. Adding a repository does not fetch any content by itself. It only tells Boundless where to find installable sources.
- A source is a JavaScript extension that knows how to talk to one particular site: how to list its catalog, run a search, read a chapter list, and load a chapter.
You add repositories. From a repository, you install sources. Both live under the Settings tab.
Adding the official repository
The official Boundless repository is:
https://boundless.moe/repo
It contains only public-domain and openly licensed content.
- Open Settings and go to the source repositories screen.
- Add the URL above.
- Wait for the repository to load its list of sources.
- Install the source you want.
Right now the official repository offers two sources: Project Gutenberg and Komga Demo. Project Gutenberg gives you more than 70,000 public-domain books, with browsing, search, and genre filtering, full reading inside the app, and books split into real chapters rather than a single continuous file. Komga Demo connects to Komga's own public demo server, so you can see what a self-hosted comics and manga library looks like inside Boundless before you set one up yourself. Either is a good way to confirm your setup works before you go further.
How sources actually work
This part matters, because it explains most of the app's behavior.
- Sources are JavaScript, and they run on your device, inside JavaScriptCore.
- When a source loads a page or an image, the request goes from your device straight to whatever site that source targets.
- Boundless does not host content, does not proxy requests, and does not cache anything on a server. There is no Boundless server in the path at all.
A few practical consequences follow from that:
- Speed and reliability depend on the site the source points at, not on Boundless.
- If that site is down, slow, or has changed its layout, the source will show it. Extensions can break when a site is redesigned.
- Anything a source fetches is fetched with your connection, from your IP address.
Adding a repository means running code from that repository on your device. Add repositories you actually trust, and be aware that you are responsible for the content and the sites your chosen sources reach.
Adding other repositories
Boundless does not curate the wider ecosystem, and it cannot vouch for a repository you found elsewhere. Before you add one, it is worth asking:
- Who publishes it, and can you tell?
- What sites do its sources target, and are you comfortable with your device fetching from them?
- Is the content there something you have a right to read in your country?
The official repository sticks to public-domain and openly licensed material precisely so there is a safe default that raises none of those questions.
Managing what you have installed
Repositories and installed sources are managed from the same Settings screens where you added them. Removing a source stops it from appearing in Browse and Search. Your locally stored library entries, progress, and history are separate from the extension itself, so removing and reinstalling a source is a normal thing to do when one starts misbehaving.
If a repository fails to load, first check the URL for a typo, then check that your device has a working connection. Troubleshooting covers the rest.
Next steps
Once a source is installed, move on to Your library for adding titles and managing chapters, or straight to Reading.