Monkies

Simple starter app to understand Couchbase Mobile with Xamarin.

Monkies (a Xamarin forms app)

This is a demo app showing how to use the Couchbase Lite framework to embed a nonrelational ("NoSQL") document-oriented database in an Xamarin Forms app and sync it with Couchbase Server in "the cloud".

This is also simple tutorial

This source works a a simple step-by-setp guide to understand Couchbase mobile with Xamarin.

Branch - Main

Starting point, just a normal no special Xamarin App.

Branch - Tutorial Part #1

Added References to Couchbase Mobile and implemented basic storage.

Branch - Tutorial Part #2

Added Sync, now the app has been converted to an Offline first app.

Branch - Tutorial Part #3

Added search to the app, this is a bit more advanced and uses view's + reflection to make a flixible search feature.

Benefits of Couchbase Lite

What does Couchbase Lite bring to the table?

• Transparent data sync. By now, users practically expect that data they enter on one device will be accessible from others, including their laptops. Couchbase Lite makes this easy. The app code operates on the local database, and bidirectional sync happens in the background.
• Flexible, schemaless database. Documents are stored as JSON, though they can be accessed as native Objective-C objects for convenience. There is no predefined schema. If you want to add new features like due dates or photo attachments, you won't have to deal with data migrations. The data will even interoperate with older versions of the app.
• Multi-user capability. With the Couchbase Sync Gateway, any number of users can securely sync with a single server database and share only the data they want to. The design of the gateway makes writing collaborative and social apps extremely easy.
• Control over the back-end server. You're not dependent on a big company to host everyone's data for you: you can run your own server, whether in a data center, on a host like EC2, or just on a spare PC in your office. It's even possible (though this app doesn't show how) to synchronize directly between two devices (P2P), with no server.
• Cross-platform. Couchbase Lite currently supports iOS, Android and Mac OS X, and its underlying data formats and protocols (as well as source code) are fully open.

Building & Running The Demo App

Down to business: You'll need a Mac with Xamarin installed to compile and run this app.

1. Clone or download this repository.
2. Open in Visual Studio.
3. Restore all Nuget Packages. (will be done by Visual Studio on first build)
4. In Solution Manager, select Android or Ios as your start-up project.
5. Click the Run button

That's it!

Quick modifications you might want to make.

Change the Sync Url to point to your personal Sync Gateway Server.

If you run your own sync gateway, the sync function source code we use is available in the sync-gateway-config.json file in the root of this repository.

To learn more and add the framework to your existing Xamarin Forms project

Please see the documentation for Couchbase Lite.

License

Released under the Apache license, 2.0.

Copyright 2011-2015, Couchbase, Inc.