My Shoppe is a cross-platform Xamarin.Forms pre-built application & template enabling you to easily connect with your customers and manage your shops. All powered by Xamarin, Xamarin.Forms, and a powerful Azure Mobile Apps backend with 100% shared C# code across iOS, Android, and Windows Phone.
This another Open Source Project by @JamesMontemagno
Built with C# 6 features, you must be running VS 2015 or Xamarin Studio to compile.
The My Shoppe consumer application enables you as a shop owner to easily connect with your consumer base. This application enables you to create a browesable list of shop locations so your consumers can find the closest location to them, call the shop, see shop hours, and even navigate to the shop with a single click.
- Browse Stores / Locations (with online/offline sync)
- Location Information: address, phone, store hours, and more
- Navigate to Location
- Call Location with 1 click
- Leave feedback for visit
In addition to the consumer application that you can release into the app stores, I created an Administration mobile application that allows you to manage all your shops and feedback from customers. It uses the same backend from the consumer application and even shares some of the same UI and code.
- Create and Manage your Shops
- Browse & Manage Feedback from consumers
- Call back consumers with a single click
My Shoppe leverages the brand new Azure App Service called Azure Mobile Apps which is the next evolution of Azure Mobile Services. I have implemented the backend datastore with a simple interface, IDataStore.cs that registers itself with the Xamarin.Forms Dependency Service. You could always create and implement your own XML or Json based service using this method.
If you just want to try out My Shoppe there is a default sample Azure backend in place, however I have removed all ability to add/update/delete stores. You can however leave feedback and moderate it from the admin app for fun. If you want to setup your own Azure Mobile app, simply follow the steps below
I have provided my existing .NET Backend for reference on how to create your controllers and data entities to publish to Azure. Read through the Azure Mobile Apps tutorial to learn how to create and setup your own Mobile Apps backend for My Shoppe.
The Guide above walks you through settings up a default backend with a ToDo List, but we need to customize it a bit more. Ensure that you have the Azure SDK for .NET installed as you will need this for publishing and also to create the controllers.
Open the server solution and under DataObjects add Feedback.cs and Store.cs from MyShoppe/MyShopApp_Web/MyShopAppService/DataObjects. Ensure you update your namespaces correctly.
Under Controllers simply right click and Add -> New Item... and if you have the Azure tools you will see New Scaffold Item. Select this option.
Now Select New Azure Mobile App Controller
Select your DataObject, DataContext, and finalize the name (I use the default of StoreController and FeedbackController).
Do this for both Feedback and Store, and you are all set! You may want to remove all of the ToDo DataObjects and Controllers.
Once you have your backend setup you will want to enter your very own Azure Mobile Apps credentials in the AzureDataStore.cs file on the following lines:
MobileService = new MobileServiceClient(
"Mobile App URL",
"Gateway URI",
"Application Key");
Once you have your Azure Mobile Apps backend setup you can easily add and manage stores with the My Shoppe Admin app for iOS or Android. If you do not add any stores, then no information will show up.
Xamarin Insights Integration
Xamarin Insights provides a simple and effective way real time monitoring of your mobile apps for crashes and events. My Shoppe integrated Insights for both crash reporting and event tracking. Simply follow the Xamarin Insights Documentation to create an API Key for your application. Once you have that simply replace all instances of the demo key:
Insights.Initialize("c3d88c6f124fdabdf8880b65845094bb7bad90ac");
with
Insights.Initialize("Your Key");
These will be located in the MainActivity.cs, ApplicationDelegate.cs, and MainPage.xaml.cs.
Easily adjust the shop's name, sorting, and of course customize My Shoppe to Your Shoppe with your own branding and styles.
Simply replace the hero.png images with your companies logo or banner.
Use your shop's brand colors and theming easily:
- Modify MyShoppe.Android/Resources/values/colors.xml with your Primary, Primary Dark, and Accent Color. I recommend using materialpalette.com for help.
- String Replace 3498DB with your Primary color in all xaml pages
Built in C# and powered by (Xamarin) from inside of Visual Studio and Xamarin Studio. In addition there was a plethora of amazing NuGet packages and Plugins for Xamarin that helped in the creation of this application. Please refer to to each NuGet packages license for the latest.
- Azure Mobile Services SQLiteStore
- Connectivity Plugin for Xamarin & Windows
- External Maps Plugin for Xamarin & Windows
- Image Circle Control Plugin for Xamarin.Forms
- Json.NET
- Messaging Plugin for Xamarin and Windows
- Microsoft HTTP Client Libraries
- Portable Class Library for SQLite
- Settings Plugin for Xamarin and Windows
- Windows Azure Mobile Services
- Windows Phone Theme Manager
- Windows Phone Toolkit
- Xamarin Google Play Services
- Xamarin Support Library v4
- Xamarin Support Library v7 AppCompat
- Xamarin Support Libarry v7 MediaRouter
- Xamarin.Forms
- Xamarin.Forms.Maps
- Xamarin Insights
The MIT License (MIT) Copyright (c) 2015 Refractored LLC / James Montemagno
See latest License file here.
Please see the latest at: http://refractored.ghost.io/about/