open-index/open-npm huggingface dataset:
npm package: @maplarge/adk
Description: The MapLarge Application Development Kit
Author: MapLarge, Inc.
Latest version: 0.0.133
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# MapLarge Application Development Kit
The MapLarge ADK provides developers a framework for building extensions for a MapLarge server instance.  

### Install the MapLarge CLI
`npm install -g @maplarge/cli`

### Create an ADK project
`maplarge adk create-project -name [yourprojectname]`

### Initialize your project
In order to debug/test an ADK extension, you must have a running MapLarge server instance.  The init command will
configure your project to communicate with the server instance you specify.

`cd [yourprojectname]`

`maplarge adk init -remoteServer [url]`

### Create an extension
`maplarge adk create-extension -name [yourextensionname] -template hello-world`

### Build and run your extension
`maplarge adk run`

## Release Notes
**0.0.108** - Fix for setting Leaflet base URL
npm package: @maplarge/adk-templates-base
Description: Base templates for getting started developing with the MapLarge ADK.
Author: MapLarge, Inc.
Latest version: 0.0.20
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# MapLarge Base Templates 
A collection of templates for getting started developing with the MapLarge ADK.
npm package: @maplarge/cli
Description: Command-line interface (CLI) for bootstrapping MapLarge ADK projects
Author: MapLarge, Inc.
Latest version: 0.0.145
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# MapLarge CLI 
The MapLarge Command Line Interface provides developers the ability to create extensions to a MapLarge server instance.
npm package: @maplarge/ngx-maplarge
Description: Angular services and components for integrating MapLarge functionality.
Author: MapLarge, Inc.
Latest version: 0.0.17


# Installation

  

From your angular project directory, run:

```

npm install --save @maplarge/ngx-maplarge

```

## Setup
 

The MapLarge module and components are used to authenticate against and interact with a live MapLarge server.  The following example outlines how you can integrate MapLarge into the root component of an angular app, app.component, however these steps can be performed from any child component.

1. Set up `mapLargeServiceOptions` in your app's environment:

	**/src/environments/environment.ts**
	```typescript

	export  const  environment = {
		production:  false,
		mapLargeServiceOptions: {
			serverUri:  "http://my.maplarge.server",
			username:  "maplarge@user.com",
			password:  "password1"
		}
	};

	```

2. Import `MapLargeModule` to root or feature module in your Angular app, and add a provider to specify environment configuration:

	**/src/app/app.module.ts**
	```typescript
	import { MapLargeModule } from  '@maplarge/ngx-maplarge';

	...

	@NgModule({
		imports: [MapLargeModule],
		providers: [
			{provide:  MapLargeInitOptions, useValue:  environment.mapLargeServiceOptions}
		]
	})

	```
	
## Add a dashboard to a component

Add the MapLarge-Dashboard component to your template
	**/src/app.component.html**

```html

<maplarge-dashboard  id="your-maplarge-dashboard-id">
	<scope-bindings>
		<scope-binding  path="scopePath" [(value)]="angularComponentVariable"></scope-binding>
	</scope-bindings>
</maplarge-dashboard>

```
**scope-bindings**
Scope Bindings are optional parameters that can be configured with a dashboard component declaration to two-way bind variables in your angular component directly to MapLarge scope variables.

## Interact directly with the MapLarge JS API

In addition, or alternatively, you can interact directly with the MapLarge Javascript API via the 'ml' instance.

   **/src/app.component.ts**

```typescript
import { MapLargeService } from  '@maplarge/ngx-maplarge';

export class AppComponent implements OnInit{

  constructor(
    private  mlsvc: MapLargeService
  ) {}
   
  ngOnInit() {
    this.mlsvc.ready((ml) => {
		  console.log("MapLarge Ready", ml);
	  })
    .catch((err: any) => {
      console.log("Error initializing MapLarge Service.", err);
    });
   }
}
```