LogoLogo
Main siteIcon SearchSource Code
  • Welcome to the Arcticons Knowledge base
  • FAQ
    • Icon Requests
    • Supported Launchers
    • Donate
    • Feedback & Suggestions
  • Troubleshooting
  • Contribute
    • GitHub guide
    • Creating icons
    • Credit Yourself
    • Vector editing software
      • Inkscape
      • Vector Asset Creator
    • Updating existing apps
    • Categorize icons
    • The IconRequest App
      • Gather the Appfilter code for an installed App
      • Get Appfilter and Icons
    • Building the app yourself
  • Other platforms
    • Linux
      • Installation
      • Contribute
      • Advanced: Generate your own flavour of Arcticons
    • OnionOS
    • iPhone
  • Request Dashboard
  • Changelog
  • Community
  • Work with Arcticons
    • Arcticons for Business
    • Launcher developers
Powered by GitBook
On this page
  • Forking Arcticons
  • Adding your icons
  • Uploading to GitHub
  • Uploading in Browser

Was this helpful?

Export as PDF
  1. Contribute

GitHub guide

PreviousContributeNextCreating icons

Last updated 10 months ago

Was this helpful?

Forking Arcticons

  • Go to the GitHub page in a browser.

  • In the top-right corner, click the Fork button. You'll get your very own clone of Arcticons! (You need a GitHub account for this).

I'd recommend using to make Git less difficult.

  • Download & Install GitHub Desktop, and login with your credentials

  • Click on Add > Clone repository and select your Arcticons repo. This will create a folder with the Arcticons project.

Now you have your local Arcticons project. This means you can add icons and edit the appfilter.

Adding your icons

After having your icons created, you can export them as SVG files to the /newicons directory.

In this folder, you'll also see a file named appfilter.xml To tie the icon to the app, you will need to add some lines of code to this file. These lines of code can be gathered with .

  1. Download on your phone

  2. In the app, tap update existing.

  3. Select Arcticons when asked to choose an icon pack.

  4. Select the apps that you want to add.

  5. Tap the share icon in the top-right corner and send it to yourself.

Now you can add these lines to the appfilter. You don't have to worry about putting everything in alphabetical order, just paste it somewhere. It gets sorted automatically with every release.

Uploading to GitHub

Now, when you open your GitHub Desktop window, you'll see a summary of the changes that you've made.

  1. Give your commit a small summary.

  2. Press the Current branch button, then create a new branch. Give it a name and press Create.

  3. Publish your branch and commit the changes.

  4. Now you can create a pull request by pressing the button. This will open the GitHub site again.

  5. Create your pull request and you're done!

There you go, now all you have to do is wait for it to be merged into the app.


Alternatively, you can also do it all in your browser:

Uploading in Browser

  • In the top-right corner, click the Fork button. You'll get your very own clone of Arcticons! (You need a GitHub account for this).

  • Once in your fork, click "newicons" directory.

  • Click "Add file" > Upload files > choose your files.

  • Select your masterpiece(s) and commit changes (you can add a commit message if you want).

  • There will be a dialog "… is 1 commit ahead of Arcticons-Team/Arcticons:main".

  • Click "Contribute" > "Open pull request".

  • Type the pull-request message (e.g., name of the icons).

  • Click "create pull request".

There you go! Just wait for your changes to be merged into the app, and be happy, you are a contributor!

Go to the GitHub page in a browser.

https://github.com/Arcticons-Team/Arcticons/
GitHub Desktop
Icon Request
Icon Request
https://github.com/Arcticons-Team/Arcticons/