# docs-v7 **Repository Path**: mirrors_NativeScript/docs-v7 ## Basic Information - **Project Name**: docs-v7 - **Description**: Documentation, API reference, and code snippets for NativeScript - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2023-02-13 - **Last Updated**: 2026-01-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # NativeScript Documentation (v7 and below) Home of the NativeScript documentation content that lives at . Start [contributing](#contributing) today! ## What’s In This Document * [Contributing 🍺](#contributing) * [About Jekyll :nut_and_bolt:](#about-jekyll) * [Configuration ⚙️](#configuration) * [Local Setup :computer:](#local-setup) * [Contributors ❤️](#contributors) ## Contributing The NativeScript documentation is completely open-source and we love contributions. Whether you want to fix a typo or write an entire article, the NativeScript documentation is a great way to get started contributing to an open-source project. Don’t know where to start? Check out the [list of issues with the “help wanted” label](https://github.com/NativeScript/docs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22). New to git or GitHub? [Join our community Slack chat](https://www.nativescript.org/slack-invitation-form) and we’ll be happy to help get you up and running. The `master` branch contains the most up-to-date version of the NativeScript documentation and its contents are uploaded to [docs.nativescript.org](https://docs.nativescript.org/). When contributing to the documentation, always create a branch for your work from `master` as this will facilitate easier pull request management. ### Are my contributions limited to this repo only? No, my friend. There are many other code repositories in the NativeScript world you might also be interested in contributing to: - [nativescript-cli](https://github.com/NativeScript/nativescript-cli) - This repo contains the NativeScript command-line interface, which lets you create, build, and run apps using the NativeScript framework. The CLI is written in TypeScript. - [nativescript-angular](https://github.com/NativeScript/nativescript-angular) - This repository contains the TypeScript code that integrates Angular with NativeScript. - [nativescript-vue](https://github.com/nativescript-vue) - This community-run project allows NativeScript to integrate with Vue.js. - [ios-runtime](https://github.com/NativeScript/ios-runtime) - This repo contains the NativeScript iOS runtime — the code that hosts NativeScript iOS apps, and allows JavaScript code to be executed on iOS devices. The iOS runtime is written in a fun mix of C++, Objective-C, and more. - [android-runtime](https://github.com/NativeScript/android-runtime) - This repo contains the NativeScript Android — the code that hosts NativeScript Android apps, and allows JavaScript code to be executed on Android devices. The Android runtime is written in a fun mix of C++ and Java. You can go check them out and help to expand their docs, add plugins to it and even fix bugs. ## About Jekyll This documentation is built using [Jekyll](https://jekyllrb.com/docs/home/). More info on how to control the template, table of content and the project structure, in general, can be found in the [Build README](build/README.md) ## Configuration There are two versions of the NativeScript documentation that generate similar output: `nativescript` and `angular`. The former builds the vanilla NativeScript docs at [docs.nativescript.org/start/introduction](https://docs.nativescript.org/start/introduction), while the latter discusses Angular-specific topics at [docs.nativescript.org/angular/start/introduction](https://docs.nativescript.org/angular/start/introduction). Most of the content in this repository is shared between the two environments, but occasionally you may need to add environment-specific content. When you have this need you have a few options. 1. If you would like a page to appear in a single environment, add an `environment: angular` or `environment: nativescript` property to that page's front matter. Pages marked with an `environment` property will appear in a single environment, and pages _not_ marked with an `environment` property will be shared across all environments. 2. If you have a page that should appear in both environments but has different content for certain sections, you can use our built-in environment block tags. The blocks are named `angular` and `nativescript`, respectively, and can be used like this: ```md {% nativescript %}This paragraph appears only in the vanilla NativeScript documentation{% endnativescript %} This paragraph appears in both environments. {% angular %}This appears only in the Angular NativeScript documentation{% endangular %} ``` ## Local Setup If you plan to work on a non-trivial change, you will most probably want to run the documentation locally in order to give your change a try before submitting a pull request. To provide you with this opportunity without installing a ton of libraries and loose time in configuration, we have prepared a virtual environment based on a docker image, where everything is prepared for you in advance. ### Prerequisites Docker should be installed on your machine: * Open the [official Docker install page](https://docs.docker.com/engine/installation/) and follow the instructions. The NativeScript documentation is composed from multiple repositories: * [NativeScript Docs](https://github.com/NativeScript/docs) * [NativeScript Modules](https://github.com/NativeScript/NativeScript) * [NativeScript Angular](https://github.com/NativeScript/nativescript-angular) * [NativeScript JavaScript SDK examples](https://github.com/NativeScript/nativescript-sdk-examples-js) * [NativeScript Angular SDK examples](https://github.com/NativeScript/nativescript-sdk-examples-ng) ### Building the docker image Start by cloning all required git repositories in some local folder (`ns-docs` in the following examples): Open a console box (**Windows users should run a Git bash session!**) and clone the required git repositories: ```bash mkdir ns-docs cd ns-docs git clone https://github.com/NativeScript/docs.git git clone https://github.com/NativeScript/nativescript-angular.git ``` Optional: ```bash git clone https://github.com/NativeScript/NativeScript.git git clone https://github.com/NativeScript/nativescript-sdk-examples-js.git git clone https://github.com/NativeScript/nativescript-sdk-examples-ng.git git clone https://github.com/NativeScript/nativescript-cli.git git clone https://github.com/NativeScript/nativescript-ui-samples.git git clone https://github.com/NativeScript/nativescript-ui-samples-angular.git git clone https://github.com/NativeScript/nativescript-ui-samples-vue.git ``` > **NOTE**: `nativescript-ui-...` are private repositories used for building the API Reference for the NativeScript UI components. > **NOTE**: If you have these repositories locally from previous work with the documentation, be sure to delete them and start from scratch as some old files can cause problems with the current setup. Then, build the docker image by using the following command from the `ns-docs` folder: ```bash sudo docker build -t ns-docs:1.0 docs/build ``` > **NOTE**: If you received some unauthorized error, make sure you are logged into docker from the CLI. Just execute `docker login` and follow the instruction. One thing to have in mind is that docker username is your email, but docker ID is what you see on the top right when you log in to https://hub.docker.com. When executing `docker login` you need to enter your Docker ID. ### Building the documentation Start the docker image created in the previous step from the **ns-docs** folder: ```bash sudo docker run --rm -t -i -v $(pwd):/root -p 9192:9192 -t ns-docs:1.0 ``` Due to the [poor performance of mounted volumes on Mac OS](https://docs.docker.com/docker-for-mac/osxfs/#performance-issues-solutions-and-roadmap) you may use the [`delegated`](https://docs.docker.com/docker-for-mac/osxfs-caching/#delegated) mount strategy: ```bash sudo docker run --rm -t -i -v $(pwd):/root:delegated -p 9192:9192 -t ns-docs:1.0 ``` ### Adding content Edit an article in some of the repositories and navigate to http://localhost:9192 on the host machine. Notice that it might take some time for the changes to be reflected in the browser. ### Making changes * Edit some files. * Refresh your browser (depending on which files have been modified, it might take more or less time for the changes to take effect). ## Contributors The following is a list of all the people that have contributed to the NativeScript documentation. Thanks for your contributions! [tsonevn](https://github.com/tsonevn)[NickIliev](https://github.com/NickIliev)[tjvantoll](https://github.com/tjvantoll)[etabakov](https://github.com/etabakov)[ErjanGavalji](https://github.com/ErjanGavalji)[ns-bot](https://github.com/ns-bot) [radeva](https://github.com/radeva)[vakrilov](https://github.com/vakrilov)[rdlauer](https://github.com/rdlauer)[N3ll](https://github.com/N3ll)[hdeshev](https://github.com/hdeshev)[tbozhikov](https://github.com/tbozhikov) [mbektchiev](https://github.com/mbektchiev)[ikoevska](https://github.com/ikoevska)[erikruth](https://github.com/erikruth)[nsndeck](https://github.com/nsndeck)[sis0k0](https://github.com/sis0k0)[petekanev](https://github.com/petekanev) [hamorphis](https://github.com/hamorphis)[vtrifonov](https://github.com/vtrifonov)[Plamen5kov](https://github.com/Plamen5kov)[PetyaSotirova](https://github.com/PetyaSotirova)[bundyo](https://github.com/bundyo)[alexziskind1](https://github.com/alexziskind1) [atanasovg](https://github.com/atanasovg)[sipacate](https://github.com/sipacate)[MartoYankov](https://github.com/MartoYankov)[sebawita](https://github.com/sebawita)[angeltsvetkov](https://github.com/angeltsvetkov)[teobugslayer](https://github.com/teobugslayer) [ggarabedian](https://github.com/ggarabedian)[ivanbuhov](https://github.com/ivanbuhov)[lini](https://github.com/lini)[dtopuzov](https://github.com/dtopuzov)[tdermendjiev](https://github.com/tdermendjiev)[zbranzov](https://github.com/zbranzov) [EmilStoychev](https://github.com/EmilStoychev)[jasssonpet](https://github.com/jasssonpet)[KristianDD](https://github.com/KristianDD)[darind](https://github.com/darind)[vchimev](https://github.com/vchimev)[enchev](https://github.com/enchev) [pkoleva](https://github.com/pkoleva)[Mitko-Kerezov](https://github.com/Mitko-Kerezov)[rosen-vladimirov](https://github.com/rosen-vladimirov)[jlooper](https://github.com/jlooper)[boevski](https://github.com/boevski)[tgpetrov](https://github.com/tgpetrov) [vmutafov](https://github.com/vmutafov)[manoldonev](https://github.com/manoldonev)[bdlb77](https://github.com/bdlb77)[paulpv](https://github.com/paulpv)[surdu](https://github.com/surdu)[roblav96](https://github.com/roblav96) [rynop](https://github.com/rynop)[tzraikov](https://github.com/tzraikov)[PanayotCankov](https://github.com/PanayotCankov)[bradmartin](https://github.com/bradmartin)[jpenna](https://github.com/jpenna)[getsetbro](https://github.com/getsetbro) [tailsu](https://github.com/tailsu)[sitefinitysteve](https://github.com/sitefinitysteve)[dmccuskey](https://github.com/dmccuskey)[elena-p](https://github.com/elena-p)[yyosifov](https://github.com/yyosifov)[parloti](https://github.com/parloti) [burkeholland](https://github.com/burkeholland)[pelegri](https://github.com/pelegri)[felipebueno](https://github.com/felipebueno)[jbristowe](https://github.com/jbristowe)[Lampei](https://github.com/Lampei)[zh-m](https://github.com/zh-m) [000panther](https://github.com/000panther)[mudlabs](https://github.com/mudlabs)[ShawnPavel](https://github.com/ShawnPavel)[tushutripathi](https://github.com/tushutripathi)[shiv19](https://github.com/shiv19)[adrian-niculescu](https://github.com/adrian-niculescu) [alejonext](https://github.com/alejonext)[AmitGurbani](https://github.com/AmitGurbani)[AntonDobrev](https://github.com/AntonDobrev)[baskarmib](https://github.com/baskarmib)[djenitoo](https://github.com/djenitoo)[fdnhkj](https://github.com/fdnhkj) [gbhojraj](https://github.com/gbhojraj)[Hakier](https://github.com/Hakier)[shirohana](https://github.com/shirohana)[blackpanther99](https://github.com/blackpanther99)[imcgonigle](https://github.com/imcgonigle)[ignaciolarranaga](https://github.com/ignaciolarranaga) [lonerzzz](https://github.com/lonerzzz)[Bjorn576](https://github.com/Bjorn576)[jayvolr](https://github.com/jayvolr)[jonnysamps](https://github.com/jonnysamps)[digitaldrummerj](https://github.com/digitaldrummerj)[LokeCarlsson](https://github.com/LokeCarlsson) [msaelices](https://github.com/msaelices)[milejko](https://github.com/milejko)[map7](https://github.com/map7)[m-abs](https://github.com/m-abs)[Nikhil22](https://github.com/Nikhil22)[noumaans](https://github.com/noumaans) [pedromorgan](https://github.com/pedromorgan)[Razzeee](https://github.com/Razzeee)[renestalder](https://github.com/renestalder)[rodrigopires](https://github.com/rodrigopires)[TedHopp](https://github.com/TedHopp)[WilcoBreedt](https://github.com/WilcoBreedt) [devoto13](https://github.com/devoto13)[eyal7773](https://github.com/eyal7773)[miroslavaivanova](https://github.com/miroslavaivanova)[mtekp](https://github.com/mtekp)[TsvetanMilanov](https://github.com/TsvetanMilanov)[ajoslin103](https://github.com/ajoslin103) [ADmad](https://github.com/ADmad)[airandfingers](https://github.com/airandfingers)[adamunion](https://github.com/adamunion)[AjaiDubey](https://github.com/AjaiDubey)[Fusty](https://github.com/Fusty)[ADjenkov](https://github.com/ADjenkov) [Alexander-Bliznyuk](https://github.com/Alexander-Bliznyuk)[kondasoft](https://github.com/kondasoft)[amjd](https://github.com/amjd)[the-AoG-guy](https://github.com/the-AoG-guy)[devdRew](https://github.com/devdRew)[MonsieurMan](https://github.com/MonsieurMan) [gupta-ankit](https://github.com/gupta-ankit)[ABoschman](https://github.com/ABoschman)[Burgov](https://github.com/Burgov)[bensooraj](https://github.com/bensooraj)[bsyk](https://github.com/bsyk)[benjlin](https://github.com/benjlin) [brandonpearson23](https://github.com/brandonpearson23)[clounie](https://github.com/clounie)[tonjohn](https://github.com/tonjohn)[CMRHDL](https://github.com/CMRHDL)[cameronnorman](https://github.com/cameronnorman)[celso-wo](https://github.com/celso-wo) [chuckmitchell](https://github.com/chuckmitchell)[crixx](https://github.com/crixx)[chrants](https://github.com/chrants)[yapcwed](https://github.com/yapcwed)[ctp-placebo](https://github.com/ctp-placebo)[chrismullins](https://github.com/chrismullins) [ClaudioMeinberg](https://github.com/ClaudioMeinberg)[dotlens](https://github.com/dotlens)[derskeal](https://github.com/derskeal)[Darkle](https://github.com/Darkle)[CoreyCole](https://github.com/CoreyCole)[ejsuncy](https://github.com/ejsuncy) [DTV96Calibre](https://github.com/DTV96Calibre)[DannyFeliz](https://github.com/DannyFeliz)[dennistang](https://github.com/dennistang)[DimitarTachev](https://github.com/DimitarTachev)[diogocapela](https://github.com/diogocapela)[donangel](https://github.com/donangel) [dogabudak](https://github.com/dogabudak)[DrQwertySilence](https://github.com/DrQwertySilence)[dyldawg](https://github.com/dyldawg)[ezesundayeze](https://github.com/ezesundayeze)[felipebernardes](https://github.com/felipebernardes)[FrancoisCamus](https://github.com/FrancoisCamus) [codepotato](https://github.com/codepotato)[sundayglee](https://github.com/sundayglee)[grgur](https://github.com/grgur)[harikrishnana2021](https://github.com/harikrishnana2021)[hristoborisov](https://github.com/hristoborisov)[hugocarreiracosta](https://github.com/hugocarreiracosta) [jagadish-kb](https://github.com/jagadish-kb)[jkulubya](https://github.com/jkulubya)[jayoma](https://github.com/jayoma)[n3wc](https://github.com/n3wc)[JmOkay](https://github.com/JmOkay)[jofftiquez](https://github.com/jofftiquez) [jrpool](https://github.com/jrpool)[jrz](https://github.com/jrz)[joshgking](https://github.com/joshgking)[TheOriginalJosh](https://github.com/TheOriginalJosh)[jpierront](https://github.com/jpierront)[jurgentreep](https://github.com/jurgentreep) [Ksantacr](https://github.com/Ksantacr)[kharysharpe](https://github.com/kharysharpe)[LeandroDG](https://github.com/LeandroDG)[lukesammy](https://github.com/lukesammy)[macknelson](https://github.com/macknelson)[mshanak](https://github.com/mshanak) [marablayev](https://github.com/marablayev)[mrcaste](https://github.com/mrcaste)[marklanhamhc](https://github.com/marklanhamhc)[hettiger](https://github.com/hettiger)[nemephx](https://github.com/nemephx)[DanekDanek](https://github.com/DanekDanek) [realtebo](https://github.com/realtebo)[MitzaCoder](https://github.com/MitzaCoder)[mhrabiee](https://github.com/mhrabiee)[mrmowji](https://github.com/mrmowji)[LiteCatDev](https://github.com/LiteCatDev)[Natalia-Hristova](https://github.com/Natalia-Hristova) [nicoeg](https://github.com/nicoeg)[nike47](https://github.com/nike47)[oluwaseye](https://github.com/oluwaseye)[oimyounis](https://github.com/oimyounis)[Omnicouleur](https://github.com/Omnicouleur)[developer82](https://github.com/developer82) [pzanitti](https://github.com/pzanitti)[pdvorchik](https://github.com/pdvorchik)[pascualstromsnes](https://github.com/pascualstromsnes)[dodongphure](https://github.com/dodongphure)[morph3o](https://github.com/morph3o)[qkdreyer](https://github.com/qkdreyer) [rajatraj733](https://github.com/rajatraj733)[rakeshgirase](https://github.com/rakeshgirase)[ReshmaPD](https://github.com/ReshmaPD)[RohanTalip](https://github.com/RohanTalip)[ffxsam](https://github.com/ffxsam)[SamVerschueren](https://github.com/SamVerschueren) [mastix](https://github.com/mastix)[sean-perkins](https://github.com/sean-perkins)[sebastianovide](https://github.com/sebastianovide)[jalkoby](https://github.com/jalkoby)[shauntif](https://github.com/shauntif)[simmstein](https://github.com/simmstein) [SirMaxxx](https://github.com/SirMaxxx)[DasAllFolks](https://github.com/DasAllFolks)[tadeucariolano](https://github.com/tadeucariolano)[Taremeh](https://github.com/Taremeh)[TechnicalSoup](https://github.com/TechnicalSoup)[Tetrygon](https://github.com/Tetrygon) [tralves](https://github.com/tralves)[fartek](https://github.com/fartek)[tdous](https://github.com/tdous)[e2l3n](https://github.com/e2l3n)[tonymporter](https://github.com/tonymporter)[trentvb](https://github.com/trentvb) [viragumathe5](https://github.com/viragumathe5)[VladimirAmiorkov](https://github.com/VladimirAmiorkov)[weech3r](https://github.com/weech3r)[williamho](https://github.com/williamho)[Xorbert](https://github.com/Xorbert)[ycherniavskyi](https://github.com/ycherniavskyi) [csj](https://github.com/csj)[diyews](https://github.com/diyews)[doorb02](https://github.com/doorb02)[Ayushraj1](https://github.com/Ayushraj1)[ishandutta2007](https://github.com/ishandutta2007)[jacostaperu](https://github.com/jacostaperu) [jamessouth](https://github.com/jamessouth)[johannbraun](https://github.com/johannbraun)[jyotendra](https://github.com/jyotendra)[narayananl23](https://github.com/narayananl23)[pavanser](https://github.com/pavanser)[peterennis](https://github.com/peterennis) [quintonn](https://github.com/quintonn)[saiberz](https://github.com/saiberz)[saknarak](https://github.com/saknarak)[seros00](https://github.com/seros00)[shendrekbharath](https://github.com/shendrekbharath)[stevo-knievo](https://github.com/stevo-knievo) [svalchinov](https://github.com/svalchinov)[tdsmithATabc](https://github.com/tdsmithATabc)[trevordowdle](https://github.com/trevordowdle)[tsira](https://github.com/tsira)[yavulan](https://github.com/yavulan)[yjaaidi](https://github.com/yjaaidi) [bangseongbeom](https://github.com/bangseongbeom)