Skip to content

Repository files navigation

Mobiscroll

Scheduling, event calendar and resource management UI components, and Mobiscroll Connect, the calendar connectivity layer for scheduling products.

npm downloads license

Two products, used independently or together, for teams building scheduling, booking, planning and resource-management systems — rota and shift planning, field service, crew management, appointment scheduling.

This repository is the index for both, and holds the source of the open-source Mobiscroll form, notification and popup components.


Mobiscroll UI

Scheduler, event calendar, resource timeline and agenda views, plus the calendar, date, time and range pickers. Ships as plain JavaScript and jQuery builds, and as native React, Angular and Vue components — not wrappers.

What is in this repository

The open-source form, notification and popup components, Apache-2.0, published as the @mobiscroll/{framework}-lite packages on public npm.

Group Components
Forms Button, Checkbox, Dropdown, Input, Radio button, Segmented, Stepper, Switch, Textarea
Notifications Alert, Confirm, Prompt, Snackbar, Toast
Popup Modal dialog, anchored popover, bottom sheet and inline display modes, with a focus trap, the ARIA dialog role and keyboard dismissal

Same design system, theming and accessibility work as the rest of Mobiscroll — a form built with these sits next to a Mobiscroll scheduler without looking bolted on.

npm install @mobiscroll/react-lite        # React
npm install @mobiscroll/angular-lite      # Angular
npm install @mobiscroll/vue-lite          # Vue
npm install @mobiscroll/javascript-lite   # plain JavaScript
npm install @mobiscroll/jquery-lite       # jQuery

Public npm — no CLI, no registry configuration, no licence key.

Angular:

import { Component } from '@angular/core';
import { MbscModule, Notifications } from '@mobiscroll/angular-lite';

@Component({
  selector: 'contact-form',
  standalone: true,
  imports: [MbscModule],
  template: `
    <mbsc-input label="Email" type="email"></mbsc-input>
    <mbsc-button (click)="save()">Save</mbsc-button>
  `,
})
export class ContactForm {
  constructor(private notify: Notifications) {}

  save() {
    this.notify.toast({ message: 'Saved' });
  }
}

React:

import { Input, Button, toast } from '@mobiscroll/react-lite';
import '@mobiscroll/react-lite/dist/css/mobiscroll.min.css';

export default function ContactForm() {
  return (
    <>
      <Input label="Email" type="email" />
      <Button onClick={() => toast({ message: 'Saved' })}>Save</Button>
    </>
  );
}

Vue:

<script setup>
import { ref } from 'vue';
import { MbscInput, MbscButton, MbscToast } from '@mobiscroll/vue-lite';
import '@mobiscroll/vue-lite/dist/css/mobiscroll.min.css';

const showToast = ref(false);
</script>

<template>
  <MbscInput label="Email" type="email" />
  <MbscButton @click="showToast = true">Save</MbscButton>
  <MbscToast :is-open="showToast" message="Saved" @close="showToast = false" />
</template>

JavaScript:

<label>
  Email
  <input mbsc-input id="email" />
</label>
<button mbsc-button id="save">Save</button>
document.getElementById('save').addEventListener('click', function () {
  mobiscroll.toast({ message: 'Saved' });
});

jQuery:

<label>
  Email
  <input mbsc-input id="email" />
</label>
<button mbsc-button id="save">Save</button>
$('#save').on('click', function () {
  mobiscroll.toast({ message: 'Saved' });
});

What is not in this repository

The scheduling components are commercial and distributed separately:

Group Components
Event calendar system Event Calendar, Scheduler, Timeline, Agenda
Date and time Calendar, Date & Time, Range
Supporting Select

They need a trial or a licence and install through the Mobiscroll CLI: https://mobiscroll.com/docs/react/getting-started/installation


Mobiscroll Connect

One integration for Google Calendar, Microsoft Outlook, Apple Calendar and CalDAV, with a unified Calendar API, normalized calendar data, OAuth and consent flows, calendar sync and webhooks. Backend only — it works with your own UI and does not require Mobiscroll UI.

No Connect source lives in this repository. The SDK monorepo above is its home.


Tooling

Releases

CHANGELOG.md covers both products in separate sections — Mobiscroll UI on the v6 line, Mobiscroll Connect on its own, since they version independently. Entries cover the whole of each product rather than only the components in this repository, and each links to the full notes rather than restating them:

The seven Connect SDKs version independently of the API and their changelogs live with their code: https://github.com/acidb/mobiscroll-connect-sdks

Support

Issues and questions about any part of Mobiscroll are welcome here — the open-source components in this repository, the commercial UI components, and Mobiscroll Connect. A bug report, a reproduction or a documentation problem is useful wherever it comes from.

Licensed customers can also use https://mobiscroll.com/support, which is tied to your licence and private. Use that channel for anything involving an account, a licence key or data you would rather not post publicly.

Security issues: please do not open a public issue. Email security@mobiscroll.com.

Licence

The source in this repository is licensed under the Apache License 2.0 — see LICENSE. The commercial Mobiscroll UI components and Mobiscroll Connect are not covered by it and are distributed under separate commercial terms.

About

Scheduling, event calendar and resource management UI components, and Mobiscroll Connect, the calendar connectivity layer for scheduling products. Index for both; holds the open-source form components and the changelogs.

Topics

Resources

Security policy

Stars

1.5k stars

Watchers

93 watching

Forks

Releases

Packages

Used by

Contributors

Languages