aurelien0713/nativescript repository overview

⁠Nativescript – Docker Image

Docker image to run Nativescript development inside a code-server environment, ready to code in the browser.

The documentation about the Framework Nativescript can be found here : Nativescript documentation⁠

Warning : This image only have the Framework Angular by default installed to be used with Nativescript. There will be other framework available in the futur. While waiting you can add through the code server terminal another Framework
Also non Virtual Device are currently installed to test the application on mobile. The creation by default of a virtual device is currently in progress

⁠🚀 Quick Start

Start a new container:

docker run -d --name my-nativescript -p {port_1}:4200 -p {port_2}:8080 aurelien0713/nativescript:{tag}

Access your code-server in the browser at:

http://localhost:{port_2}

⁠⚙️ Configuration

You can configure the container using environment variables and volume mounts.

⁠📦 Requirements

• 3 GB of free disk space
• Docker installed

⁠🌍 Environment Variables

⁠📁 Volumes

Mount a local folder to persist your workspace:

docker run -d \
  --name my-nativescript \
  -p {port}:4200 \
  -p {port_2}:8080 \
  -v {yourPath}:/home/nativescript/workspace \
  aurelien0713/nativescript:{tag}

If you want to use the current directory :

• %cd% on Windows
• $(pwd) on Linux / macOS

Example:

docker run -d --name my-nativescript -p 4200:4200 -p 8080:8080 -v %cd%:/home/nativescript/workspace aurelien0713/nativescript:latest

⁠🔐 Security Notes

• Change the default password CODESRV_PASS before exposing to public networks.
• Avoid running as root; the container user is already configured for development.

⁠🧰 Preinstalled Tools

• Node.js & npm
• Angular CLI
• Nativescript CLI
• Git
• Android SDK (sdkmanager, avdmanager)
• JAVA 21
• VS Code extensions for Angular development
  • cdfzo.mizu
  • aaron-bond.better-comments
  • usernamehw.errorlens
  • dbaeumer.vscode-eslint
  • angular.ng-template
  • formulahendry.auto-rename-tag
  • prettier.prettier-vscode
  • nativescript.nativescript
• code-server to code in browser

⁠🛠️ Development Workflow

1. Launch the container.
2. Open the browser at http://localhost:{port}.
3. Use the integrated terminal to run Angular commands:

ns create my-app --angular
cd my-app
ns run android

1. Your project files are saved in the mounted volume for persistence.

⁠📂 Project Structure

Inside the container:

/home/angular/workspace
├─ my-app/        # Your Angular projects
├─ .vscode/       # VS Code settings
└─ node_modules/  # Dependencies (inside container)

⁠🗒 Notes

• Update Git credentials at any time with:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

• The container is designed for local development. For production builds, export your project files and build on your host machine or CI/CD pipeline.