mirror of https://github.com/hariroshan/elm-native-library.git synced 2024-12-04 06:25:25 +03:00

* testing with counter.mp4 video

* removed counter.mp4

* updated readme with video links

2023-03-12 21:27:08 +05:30

Elm Native

Build mobile apps with elm using NativeScript API. elm/http works with this library as well!

We can build simple apps like counter

or something like a blog

or even complex app with page transitions, modals, dialog, and much more!

How it works

We will use CustomElements feature to create mobile UI elements with nativescript objects and control the nativescript object from elm.

Here's a simple representation of how UI elements are created

Elm -> Nativescript -> Mobile

When we listen for / receive an event,

Mobile -> Nativescript -> Elm

Consider this flow while building an application. This will help you to overcome performance issues if you encounter them.

Use the attributes from Native.Attributes and NOT Html.Attributes

Checkout examples

Dialog
Page transitions animations
Modal page
Execution of OS specific property assignment and Native code (Be careful)
Navigating page back and forth using frame functions
Has bindings for all Nativescript UI elements
Calling methods/setting attributes in the event object within elm (Will be improved in future)
Simple and complex listviews templates and much more

More features will be added soon.

This project tooks months of research and days of work. If you feel like it is valuable to the elm community, please consider supporting this project

Clone the blank template

git clone https://github.com/hariroshan/template-blank-elm

Install dependencies using yarn or npm install
Follow the instructions to setup your mobile development enviroment
Run project using
- yarn run run:ios or npm run run:ios for iOS
- yarn run run:android or npm run run:android for Android