Setup

Dependencies

1. apt-ftparchive
   Required to generate the Packages file:

   • Windows: It will be automatically downloaded.
   • macOS: Install via Procursus apt-utils; otherwise, it will be automatically downloaded.
   • iOS / iPadOS: install via Procursus apt-utils (Elucubratus users, this is not verified).

2. wget, zstd, xz, lz4, & gpg

   • updaterepo.sh will automatically install these if Homebrew or Procursus is available.

Download / Fork repo.me

If you are not hosting your repository on GitHub Pages, you can download the zip file here and extract it to a subfolder on your website.

There are two options for those using GitHub Pages:

A. If you want to use your root username.github.io as your repo, fork this repo and rename it to username.github.io. Then, when adding it to your Package Manager of choice, use https://username.github.io.

B. If you want to use a subfolder for your existing username.github.io as your repo (e.g., username.github.io/repo), fork this repo and rename it to repo. Then, when adding it to your Package Manager of choice, use https://username.github.io/repo.

Personalization

Branding

I, uchks, do not do frontend. Provided to you is Reposi3's frontend. You don't need to use it if you know what you're doing. Otherwise, check index.html for the lines that need to be changed!

Add a "CydiaIcon.png" for your APT Repository Logo. This is not a design tutorial; it should be relatively self-explanatory.

Page Footers

The data below are the links that appear at the bottom of every Webview / Cydia Depiction. The data is stored in repo.xml at the root folder of your repository.

<repo>
    <footerlinks>
        <link>
            <name>Follow me on X</name>
            <url>https://x.com/uchkence</url> # Feel free to swap your X in for this!
            <iconclass>fa-brands fa-x-twitter</iconclass>
        </link>
        <link> # You can remove this if you wish, however if I may, please do not do so! It will allow others to find repo.me such as you have!
            <name>I want this depiction template</name>
            <url>https://github.com/uchks/repo.me</url>
            <iconclass>fa-solid fa-thumbs-up</iconclass>
        </link>
    </footerlinks>
</repo>

Depictions

Webview / Cydia Depictions

Go to the depictions folder and duplicate the folder com.example.sample. Rename the duplicate with the same name as your package name. There are two files inside the folder - info.xml and changelog.xml. Update the two files with information regarding your package. The tags are pretty much self-explanatory. Contact hi@air.rip for questions.

info.xml

<package>
    <id>com.example.sample</id>
    <name>Sample</name>
    <version>1.0.0</version>
    <compatibility>
        <firmware>
            <miniOS>5.0</miniOS>
            <maxiOS>7.0</maxiOS>
            <otherVersions>unsupported</otherVersions>
            <!--
            for otherVersions, you can put either unsupported or unconfirmed
            -->
        </firmware>
    </compatibility>
    <dependencies></dependencies>
    <descriptionlist>
        <description>This is an old package. Requires iOS 7 and below..</description>
    </descriptionlist>
    <screenshots></screenshots>
    <changelog>
        <change>Initial release</change>
    </changelog>
    <links></links>
</package>

changelog.xml

<changelog>
    <changes>
        <version>1.0.0</version>
        <change>Initial release</change>
    </changes>
</changelog>

Native / Sileo Depictions

Go to the /depictions/native/com.example.sample folder and copy the file depiction.json. Move it into a folder labeled as your package name. Edit the labeled parts (i.e., VERSION_NUMBER, TWEAK_NAME, etc.). Contact hi@air.rip for questions.

Linking the Depiction

You can add the depictions URL at the end of your package's control file before compiling it. The depiction line should look like this:

Depiction: https://username.github.io/repo/depictions/web?p=[idhere]

Replace [idhere] with your actual package name.

Depiction: https://username.github.io/repo/depictions/web?p=com.example.sample

For native depictions, add the SileoDepiction key alongside the Depiction in your control file before compiling it.

SileoDepiction: https://username.github.io/repo/depictions/native/com.example.sample/depiction.json

With your updated control file, build your tweak and store the resulting debian into the /debians folder of your repository.

The Packages file is handled by updaterepo.sh. macOS users will be asked for their password when running this due to sudo; the permissions are transmuted after apt-ftparchive is automatically pulled via wget, but not without you entering your password.

Push your changes and, if you haven't done so yet, go ahead and add your repository to your package manager. You should now be able to install your tweak from your repository.