.. _preinstalledapps:

Preinstalled apps
=================

This page will help you get started with developing the apps which are included with Ubuntu Touch.

Core apps
---------

Core apps are applications which are included with UBports distributions of Ubuntu Touch **and** placed in the OpenStore for updates. Core apps are a good "first development" experience within UBports. Many are built with `Clickable`_, an easy to use build and test system for Ubuntu Touch apps. Most core apps can even be built and run without an Ubuntu Touch device!

Which core apps currently exist?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A full list of the Ubuntu Touch core apps follows.

.. Note for markup travelers: These links are in the "bottom of page" style so they take up less space inside the table.
   Please sort the table alphabetically.
   "Application Name" should be the name that displays in the apps list in English (US)

================    ==================================  ============================
Application Name    Store page                          Code repository
================    ==================================  ============================
Calculator          `Calculator on OpenStore`_          `calculator-app on GitLab`_
Calendar            `Calendar on OpenStore`_            `calendar-app on GitLab`_
Clock               `Clock on OpenStore`_               `clock-app on GitLab`_
File Manager        `File Manager on OpenStore`_        `filemanager-app on GitLab`_
Gallery             `Gallery on OpenStore`_             `gallery-app on GitLab`_
Music               `Music on OpenStore`_               `music-app on GitLab`_
Notes               `Notes on OpenStore`_               `notes-app on GitLab`_
OpenStore           `OpenStore... on OpenStore`_        `openstore-app on GitLab`_
Terminal            `Terminal on OpenStore`_            `terminal-app on GitLab`_
UBports Welcome     `UBports Welcome on OpenStore`_     `ubports-app on GitLab`_
Weather             `Weather on OpenStore`_             `weather-app on GitLab`_
================    ==================================  ============================

Other preinstalled apps
-----------------------

The following applications are preinstalled in Ubuntu Touch but are not considered core apps. Most of the time these projects must be updated with the system because they use many system services which do not necessarily have a stable API.

These apps may be more difficult to work with, but their repository should contain a document stating how to build and run them on a device.

.. Please sort this list alphabetically by the app display name in English (US)

* Browser (`morph-browser on GitLab`_)
* Contacts (`address-book-app on GitLab`_)
* Camera (`camera-app on GitLab`_)
* External Drives (`ciborium on GitLab`_)
* Media Player (`mediaplayer-app on GitLab`_)
* Messaging (`messaging-app on GitLab`_)
* Phone (`dialer-app on GitLab`_)
* System Settings (`system-settings on GitLab`_)

Instructions for contributing to these applications can be found in their respective repositories.

.. _Clickable: http://clickable.bhdouglass.com/en/latest/

.. core app table links. Please put them here in the same order that you do in the table above.

.. _Calculator on OpenStore: https://open-store.io/app/com.ubuntu.calculator
.. _calculator-app on GitLab: https://gitlab.com/ubports/apps/calculator-app
.. _Calendar on OpenStore: https://open-store.io/app/com.ubuntu.calendar
.. _calendar-app on GitLab: https://gitlab.com/ubports/apps/calendar-app
.. _Clock on OpenStore: https://open-store.io/app/com.ubuntu.clock
.. _clock-app on GitLab: https://gitlab.com/ubports/apps/clock-app
.. _File Manager on OpenStore: https://open-store.io/app/com.ubuntu.filemanager
.. _filemanager-app on GitLab: https://gitlab.com/ubports/apps/filemanager-app
.. _Gallery on OpenStore: https://open-store.io/app/com.ubuntu.gallery
.. _gallery-app on GitLab: https://gitlab.com/ubports/apps/gallery-app
.. _Music on OpenStore: https://open-store.io/app/com.ubuntu.music
.. _music-app on GitLab: https://gitlab.com/ubports/apps/music-app
.. _Notes on OpenStore: https://open-store.io/app/com.ubuntu.reminders
.. _notes-app on GitLab: https://gitlab.com/ubports/apps/notes-app
.. _OpenStore... on OpenStore: https://open-store.io/app/openstore.openstore-team
.. _openstore-app on GitLab: https://gitlab.com/theopenstore/openstore-app
.. _Terminal on OpenStore: https://open-store.io/app/com.ubuntu.terminal
.. _terminal-app on GitLab: https://gitlab.com/ubports/apps/terminal-app
.. _UBports Welcome on OpenStore: https://open-store.io/app/com.ubuntu.ubports
.. _ubports-app on GitLab: https://gitlab.com/ubports/apps/ubports-app
.. _Weather on OpenStore: https://open-store.io/app/com.ubuntu.weather
.. _weather-app on GitLab: https://gitlab.com/ubports/apps/weather-app

.. Other preinstalled apps links. Please put them here in the same order that you do in the list

.. _morph-browser on Gitlab: https://gitlab.com/ubports/development/core/morph-browser
.. _address-book-app on GitLab: https://gitlab.com/ubports/core/address-book-app
.. _camera-app on GitLab: https://gitlab.com/ubports/apps/camera-app
.. _ciborium on GitLab: https://gitlab.com/ubports/core/ciborium
.. _mediaplayer-app on Gitlab: https://gitlab.com/ubports/development/core/lomiri-mediaplayer-app
.. _dialer-app on Gitlab: https://gitlab.com/ubports/development/core/lomiri-dialer-app/
.. _messaging-app on Gitlab: https://gitlab.com/ubports/development/core/messaging-app
.. _system-settings on GitLab: https://gitlab.com/ubports/core/lomiri-system-settings