1
1
mirror of https://github.com/NixOS/mobile-nixos.git synced 2024-12-15 19:23:01 +03:00
not really known
Go to file
2020-05-06 01:33:01 -04:00
.ci ci: Add assertion that validates evaluations are differents 2020-04-07 23:12:18 -04:00
.github/workflows actions: Init GitHub actions 2020-03-28 22:54:09 -04:00
artwork artwork: Remove now unneeded sad-phone png 2020-03-09 18:17:36 -04:00
bin bin/kernel-normalize-config: Use bin/menuconfig 2020-03-27 16:34:33 -04:00
boot boot/init: Use the new error reporting applet 2020-03-09 19:45:49 -04:00
devices qemu-x86_64: Use qemu EDID support 2020-04-22 22:48:30 -04:00
doc doc: Fix article without image 2020-05-06 01:33:01 -04:00
examples/demo demo: Expose build attribute 2020-02-03 21:58:22 -05:00
lib lib/configuration.nix: Add method for importing in system configuration 2020-04-06 23:01:57 -04:00
modules cross-workarounds: Disable udisks for cross-builds 2020-04-23 00:01:33 -04:00
overlay seabios: Remove, to rely on qemu EDID support 2020-04-22 22:47:56 -04:00
profiles Adds an installer output... 2019-09-21 22:45:41 -04:00
systems rootfs: Add Hydra build product 2020-03-31 15:53:47 -04:00
.gitignore WIP : Builds a system image using nixos. 2018-06-23 17:11:07 -04:00
CONTRIBUTING.adoc doc: Add a contributing document 2020-04-29 18:02:34 -04:00
default.nix default.nix: Pass additional config to evalWith 2020-04-07 23:13:07 -04:00
LICENSE LICENSE: update license notice 2020-05-04 19:28:41 -04:00
README.adoc README: review README content 2020-05-04 21:47:27 -04:00
release.nix release-tools: Split useful Mobile NixOS evaluation tools 2020-04-04 14:39:23 -04:00
shell.nix Added additional development tools 2019-10-27 00:45:47 +10:00

++++
<div align="center"><a href="https://mobile.nixos.org/"><img src="artwork/logo/logo.svg" alt="Mobile NixOS" title="Mobile NixOS" width="500" height="130" /></a></div>
++++

*Mobile NixOS* is a superset on top of link:https://nixos.org/nixos/[NixOS Linux],
link:https://nixos.org/nixpkgs/[Nixpkgs] and link:https://nixos.org/nix/[Nix],
aiming to abstract away the differences between _mobile_ devices.

In four words: _“NixOS, on your phone”_.

ifdef::env-github[]
Read more: <<doc/about.adoc#,About Mobile NixOS>>.
endif::[]
ifndef::env-github[]
Read more: <<about.adoc#,About Mobile NixOS>>.
endif::[]

== Documentation

 * link:https://mobile.nixos.org/[The Mobile NixOS website] hosts the rendered link:https://github.com/NixOS/mobile-nixos/tree/master/doc[doc folder] for Mobile NixOS documentation.

As Mobile NixOS is a superset of NixOS Linux, the following documentation applies:

 * link:https://nixos.org/nixos/manual[NixOS Manual] - how to install, configure, and maintain a purely-functional Linux distribution
 * link:https://nixos.org/nixpkgs/manual/[Nixpkgs Manual] - contributing to Nixpkgs and using programming-language-specific Nix expressions
 * link:https://nixos.org/nix/manual[Nix Package Manager Manual] - how to write Nix expressions (programs), and how to use Nix command line tools

== Community

Mobile NixOS development and questions is currently hosted on the AArch64
channel for NixOS.

 * link:irc://irc.freenode.net/#nixos-aarch64[IRC - #nixos-aarch64 on freenode.net]

The following community resources are also available, for NixOS questions.

 * link:irc://irc.freenode.net/#nixos[IRC - #nixos on freenode.net]
 * link:https://discourse.nixos.org/[Discourse Forum]

== Other Project Repositories

 * link:https://github.com/NixOS/nix[Nix] - the purely functional package manager
 * link:https://github.com/NixOS/nixpkgs[Nixpkgs] - the Nix packages collection

== Continuous Integration

Mobile NixOS is continuously built on the link:https://hydra.nixos.org/[organization's Hydra instance].

 * link:https://hydra.nixos.org/jobset/mobile-nixos/unstable[Against the `nixos-unstable` branch of NixOS]
 ** link:https://hydra.nixos.org/job/mobile-nixos/unstable/tested[`tested` job]

There is no published artifacts for the time being, but the documentation
should point you towards resources that you can use to get started quicker when
your device is supported.

== Contributing

There are two ways your contributions can reach this project.

ifdef::env-github[]
 * <<CONTRIBUTING.adoc#,Contributing to Mobile NixOS>>
endif::[]
ifndef::env-github[]
 * <<contributing.adoc#,Contributing to Mobile NixOS>>
endif::[]
 * link:https://github.com/NixOS/nixpkgs/blob/master/.github/CONTRIBUTING.md[Contributing to Nixpkgs or NixOS]

Contributions are always welcome. If it's your first time contributing:
jump in and don't be scared. Mistakes in your first contributions are room for
improvement; it is not in our nature to scold new contributors.

== License

Mobile NixOS is licensed under the link:https://github.com/NixOS/mobile-nixos/blob/master/LICENSE[MIT License].

[NOTE]
====
As with Nixpkgs, the MIT license does not apply to the packages built,
but only to the files in this repository (expressions, scripts, modules, etc.).

Patches and derivative work are covered by the licenses of their respective
packages.
====