If you just want to get a feel for the kind of apps you can create with Synchro, kick the tires.
If you want to install Synchro and serve your own app, take a test drive.
Either way, you'll be running Synchro in just a few minutes!
Synchro Civics is an app built on the Synchro platform and running in the cloud. Its uses the Google Civic Information API to show your representatives at every level of government based on your address. Synchro Civics leverages location services on your device and the Google reverse geolocation API to determine your approximate street address. It also allows you to mark certain government officials as favorites, and it remembers your favorites and recently used addresses between sessions. Synchro Civics will even launch other apps on your device to interact with your represenatives.
If you haven't already done so, install Node.js
$ npm install -g synchro
Create a directory and switch to it, then in the new directory:
$ synchro init $ synchro new hello
This will install Synchro as a Node.js app in the directory, and create a new Synchro app called "hello".
$ npm start
This will start a Node.js server instance running the Synchro server, which will be serving your new app.
Using a web browser, navigate to the host/port on which Node.js and Synchro are running. This will typically be http://localhost:1337.
The Synchro web app server will be running by default, so you may choose the "Web App" link from the app list page to visit the web form of the hello app you created above.
When you are ready to deploy your app to end users, you will use the Synchro App Builder to create custom branded application packages for each desired mobile platform. The Synchro Civics app is an example of an app created with the Synchro App Builder.
For development and testing purposes, you will download the Synchro Explorer app onto your mobile device from the appropriate app store. Synchro Explorer is preconfigured with the Synchro Civics endpoint, as well as the Synchro Samples endpoint.
From the Synchro Explorer main screen, select "add" and enter the endpoint of your application running on your server. The address must be reachable by
the device on which you're running Synchro Explorer (i.e. not a localhost or loopback address), and the app must be running on your server when you add it to Synchro Explorer.
Your endpoint will typically be in the form:
Once you've found and added your app, it will show up in the app list in Synchro Explorer. You can then launch it from there by tapping.
If you would like to install and run the Synchro Samples app locally, you can do so by stopping your Synchro server instance, then doing:
$ synchro install https://github.com/SynchroLabs/SynchroSamples/archive/master.zip
When you restart your Synchro server, you will be serving the Synchro Samples on your own endpoint. You can then add this endpoint to Synchro Explorer as above.
Review the Synchro Tutorial to get a step-by-step walk through of Synchro concepts, mostly outlined in code.
If you would like to install and run the Synchro Tutorial app locally, you can do so by stopping your Synchro server instance, then doing:
$ synchro install https://github.com/SynchroLabs/SynchroTutorial/archive/master.zip
When you restart your Synchro server, you will be serving the Synchro Tutorial on your own endpoint. You can then add this endpoint to Synchro Explorer as above.
When you visit the web site provided by the Synchro server, as you did above to verify it was running, you will see a list of the Synchro apps running on that server. If you click one of these apps, you will enter a debugging and editing environment for the selected app. Note that this feature can be either disabled or protected by a login for production systems.
You can select modules to view in the list on the left. Experiment by setting breakpoints and running the debugger, then accessing the app via Synchro Explorer. You can also edit these modules in place and deploy them, even while a client is running, with the client behavior reflecting the updated code in real time.