Azure Mobile Apps - Node SDK

Basic Usage

The Azure Mobile Apps Node.js SDK is an express middleware package which makes it easy to create a backend for your mobile application and get it running on Azure.

var app = require('express')(); // Create an instance of an Express app
var mobileApp = require('azure-mobile-apps')(); // Create an instance of a Mobile App with default settings

mobileApp.tables.add('TodoItem'); // Create a table for 'TodoItem' with default settings

app.use(mobileApp);
app.listen(process.env.PORT || 3000);

Installation

npm install --save azure-mobile-apps

Documentation & Resources

• API Documentation
• Samples
• Tutorials & How-Tos
• Azure .NET SDK
• Client & Server Quickstarts
• StackOverflow #azure-mobile-services
• MSDN Forums
• Chat on Gitter

Quickstart

1. Create a new directory, initialize git, and initialize npm

mkdir quickstart
cd quickstart
git init
npm init --yes

2. Install (with npm) the azure-mobile-apps and express packages

npm install express azure-mobile-apps --save

3. Create a suitable .gitignore file. You can generate a suitable .gitignore file using the generator at gitignore.io

4. Create a server.js file and add the following code to the file (or use the code from one of our samples):

var app = require('express')(); // Create an instance of an Express app
var mobileApp = require('azure-mobile-apps')(); // Create an instance of a Mobile App with default settings

mobileApp.tables.add('TodoItem'); // Create a table for 'TodoItem' with default settings

app.use(mobileApp);
app.listen(process.env.PORT || 3000);

5. Run your project locally with node server.js

6. Publish your project to an existing Azure Mobile App by adding it as a remote and pushing your changes.

git remote add azure https://{user}@{sitename}.scm.azurewebsites.net:443/{sitename}.git
git add package.json server.js
git commit -m 'Quickstart created'
git push azure master

To test steps 4-5, you can use any of the clients found in the Client & Server Quickstarts.

Running Tests

To run the suite of unit and integration tests, execute the following commands in a console window.

git clone https://github.com/Azure/azure-mobile-apps-node.git
cd azure-mobile-apps-node
npm i
npm test

This runs tests using the default embedded SQLite data provider. To execute tests against SQL Server, create a configuration file called azureMobile.js in the test directory that contains relevant data configuration. See the API reference for more information.

GitHub Organization

Our GitHub repository has one branch with code in it - master. Each version is tagged with the version when we release a new version. We have three suffixes for the release. An alpha release indicates that the API may be unstable between releases and the library may not pass the end to end tests yet. You should not use an alpha release in production or testing. We release alpha releases to provide an early look at the library. Has all the functionality we expect in the final release and should be API stable, so it can be used for development. A beta library release may not pass end to end tests yet. A GA release passes all end to end tests and is recommended for production code.

We use GitHub Issues to track all work with this library. We use Milestones to track the work going into a particular release.

Future of Azure Mobile Apps

Microsoft is committed to fully supporting Azure Mobile Apps, including support for the latest OS release, bug fixes, documentation improvements, and community PR reviews. Please note that the product team is not currently investing in any new feature work for Azure Mobile Apps. We highly appreciate community contributions to all areas of Azure Mobile Apps.

Contributing

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

For information on how to contribute to this project, please see the contributor guide.

Contact Us

We can be contacted via a variety of methods. The most effective are on Twitter (via @AzureMobile) and the MSDN Forums If you need to reference a GitHub Issue, ensure you cut-and-paste the URL of the issue into the message. You can also reach us on Gitter.

License

MIT