penk / terrarium-app Goto Github PK

UI Prototyping Tool for Coders

License: MIT License

Makefile 0.23% QML 49.75% C++ 47.43% QMake 2.59%

terrarium-app's Introduction

Terrarium - UI Prototyping Tool for Coders

Terrarium is a cross platform QML Playground: the view renders lively as you type in the editor, makes prototyping and experimenting with QtQuick a lot more fun!

It monitors changes in its TextEdit, and triggers the view to reload source from the local http server. If you're looking for a file system watcher implementation, please refer to QML LiveReload.

More details on http://www.terrariumapp.com

Download

Build Instructions

git clone https://github.com/penk/terrarium-app.git
cd terrarium-app && git submodule init && git submodule update
qmake && make

Platform Specific Instructions

For Arch-Linux

Just go to AUR: yaourt -S terrarium-git

For Mac OSX/iOS

To add icons to iOS build, first generate and open Terrarium.xcodeproj, switch AppIcon to use Assets Catalog, then replace Terrarium/Images.xcassets/ directory with platform/ios/Images.xcassets.

As for Mac OSX, refer to macdeployqt command in terrarium-app.pro file.

For Ubuntu Desktop/Phone

If you're using Qt packages from apt archive instead of qt-project.org releases, here's the dependencies:

sudo apt-get install qt5-qmake qt5-default qtbase5-dev qtdeclarative5-dev build-essential

All debian/ package information can be found under platform/ubuntu/ directory, copy it to current path and build the package by:

cp -r platform/ubuntu/debian .
cp platform/ubuntu/terrarium.desktop .
dpkg-buildpackage -b

If you're building click package, execute following command on device (for native compile):

cp platform/ubuntu/* .
click build .

And install it

pkcon --allow-untrusted install-local com.ubuntu.developer.penk.terrarium_1.5_armhf.click

For Android

First generate your keystore by keytool

keytool -genkey -v -keystore ../TerrariumApp.keystore -alias TerrariumApp -keyalg RSA -keysize 2048 -validity 10000

then

~/Qt5.4.1/5.4/android_armv7/bin/qmake
make
make install INSTALL_ROOT=../android-terrarium

Build and sign apk by:

~/Qt5.4.1/5.4/android_armv7/bin/androiddeployqt --input \
    android-libTerrarium.so-deployment-settings.json \
    --output ../android-terrarium --release --sign ../TerrariumApp.keystore TerrariumApp

Screenshots

LICENSE

Copyright © 2014-2015 Ping-Hsun (penk) Chen [email protected]
The source code is, unless otherwise specified, distributed under the terms of the MIT License.

CREDITS

DocumentHandler by Benoît HERVIER
QMLHighligher by Alan Alpert
QHttpServer by Robert Schroll
Font Awesome by Dave Gandy

terrarium-app's People

Contributors

Stargazers

Watchers

terrarium-app's Issues

add auto-indentation (beautify) support

this is essential to keep sane for non-trivial prototypes :-)

Additional dependency needed

For me I also had to install qml-module-qtquick-localstorage for terrarium to work.

Just thought I'd let you know!

viewLoader.errorString() is a Property, not a function

And it comes out as undefined.

Line 125 of main.qml

WebView for QMLWeb?

It would be cool if you could also load the web version ( https://github.com/qmlweb/qmlweb )

I figure all you need is a QWebEngine and a root html?

Garbled text

Used to display text ok, now doesn't. I'm en_US.

AppImage for Linux

Providing an AppImage would have, among others, these advantages:

Applications packaged as an AppImage can run on many distributions (including Ubuntu, Fedora, openSUSE, CentOS, elementaryOS, Linux Mint, and others)
One app = one file = super simple for users: just download one AppImage file, make it executable, and run
No unpacking or installation necessary
No root needed
No system libraries changed
Works out of the box, no installation of runtimes needed
Optional desktop integration with appimaged
Optional binary delta updates, e.g., for continuous builds (only download the binary diff) using AppImageUpdate
Can optionally GPG2-sign your AppImages (inside the file)
Works on Live ISOs
Can use the same AppImages when dual-booting multiple distributions
Can be listed in the AppImageHub central directory of available AppImages
Can double as a self-extracting compressed archive with the --appimage-extract parameter

Here is an overview of projects that are already distributing upstream-provided, official AppImages.

If you have questions, AppImage developers are on #AppImage on irc.freenode.net.

Publish Ubuntu Touch version on the open-store.io?

Seems to work nicely on the latest ubports version of Ubuntu Touch.

Why not publish it on the open-store.io

Thanks!

[Feature Request] A message window to show the error of editing QML source code

When user made any syntax error on the editing QML source code , it will simply clear the preview and user will not know what is wrong with their code. Therefore, I would like to suggest to add a message window that could report the errors with line no. So that user could know what is wrong with their code and correct it.

add QtWebKit in binary package

penk,

I believe we need QtWebKit for basic prototyping purpose :)

There is no Terrarium.xcodeproj in the repo

Terrarium.xcodeproj is missing, it's needed to build MAC/iOS app.

Autocomplete support

Hi!

Just found about Terrarium and it looks really interesting! Congrats!

Are there any plans to add autocomplete support? This would really help people starting to learn QML.