Skip to main content

Migrating from FullCalendar to Mobiscroll

Overview​

This article provides a comprehensive guide for migrating your scheduling solution from FullCalendar to Mobiscroll in Vue. It highlights the key differences between the two libraries and outlines step-by-step instructions, covering installation, configuration, resources, events, and features, ensuring a smooth and informed transition.

FullCalendar integrates with Vue through its official <FullCalendar /> component, while Mobiscroll provides native Vue components that plug directly into templates through standard bindings.

If you are currently using FullCalendar in Vue and planning to migrate to Mobiscroll’s Vue components, the following guide outlines the steps required for a smooth transition.

Installation​

Migrating from FullCalendar to Mobiscroll starts with a different approach to installation, especially regarding package access and tooling.

Mobiscroll installation steps:​

Install the Mobiscroll CLI (only needed once):

npm install -g @mobiscroll/cli

Configure Mobiscroll in your project (navigate to your project root folder and run):

mobiscroll config vue

Alternatively, Mobiscroll also supports manual installation if you’re not using NPM. However, using NPM is generally the recommended approach for simplicity and maintainability.

Initialization​

FullCalendar:​

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import dayGridPlugin from '@fullcalendar/daygrid'

const calendarOptions = {
  plugins: [dayGridPlugin],
  initialView: 'dayGridMonth'
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll:​

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'
</script>

<template>
  <MbscEventcalendar />
</template>

View configuration​

Key Differences:

  • With Mobiscroll, you get precise control over time ranges on Scheduler and Timeline views, plus feature-rich Event Calendar and Agenda views for seamless scheduling.
  • FullCalendar uses plugins and view-specific options. Standard calendar layouts such as month, week, day, and list are available through separate packages, while timeline and resource-based scheduling require Premium plugins.

FullCalendar Timeline view:​

In FullCalendar, the Timeline view is configured through the initialView, slotMinTime, and slotMaxTime options. Resource-based timeline scheduling also requires the resourceTimelinePlugin and a resources array.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import resourceTimelinePlugin from '@fullcalendar/resource-timeline'

const calendarOptions = {
  schedulerLicenseKey: 'YOUR_LICENSE_KEY',
  plugins: [resourceTimelinePlugin],
  initialView: 'resourceTimelineDay',
  initialDate: '2017-01-01',
  slotMinTime: '06:00:00',
  slotMaxTime: '20:00:00'
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll Timeline view:​

In the Mobiscroll Timeline view, the timeline object within the view option allows you to customize the visible days and the timeline’s scale. You can specify which days to display (e.g., weekdays), set the time scale (e.g., 30-minute intervals), and define the frequency of the labels shown.

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myView = {
  timeline: {
    type: 'day',
    size: 1,
    startTime: '06:00',
    endTime: '20:00'
  }
}

const mySelectedDate = '2017-01-01' // if you want to set the initial view to a specific date
</script>

<template>
  <MbscEventcalendar :view="myView" :defaultSelectedDate="mySelectedDate" />
</template>

Check out how you can configure the Timeline view in this live example.

FullCalendar TimeGrid view:​

For a scheduler-style week layout in FullCalendar, the most common setup is timeGridWeek and this needs to be specified with the initialView. You choose the initial date with initialDate.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [timeGridPlugin],
  initialView: 'timeGridWeek',
  initialDate: '2020-09-12'
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll Scheduler:​

You can customize the visible days and hours, as well as the time grid scale, using the schedule object under the view option. This allows you to define which days are shown, set the visible time range, adjust the time scale, and control the frequency of the labels.

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myView = {
  schedule: {
    type: 'week'
  }
}

const mySelectedDate = '2020-09-12' // if you want to set the initial view to a specific date
</script>

<template>
  <MbscEventcalendar :view="myView" :defaultSelectedDate="mySelectedDate" />
</template>

Check out how you can configure the Scheduler view in this live example.

Resource configuration​

Migrating resource data from FullCalendar to Mobiscroll should be relatively straightforward.

FullCalendar - resource definition:​

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import resourceTimelinePlugin from '@fullcalendar/resource-timeline'

const calendarOptions = {
  schedulerLicenseKey: 'YOUR_LICENSE_KEY',
  plugins: [resourceTimelinePlugin],
  initialView: 'resourceTimelineDay',
  resources: [
    { id: 'r1', title: 'Mike' },
    { id: 'r2', title: 'Linda' },
    // ...
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll Timeline view/ Scheduler - resource definition:​

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myResources = ref([
  { id: 'r1', name: 'Mike' },
  { id: 'r2', name: 'Linda' },
  // ...
])
</script>

<template>
  <MbscEventcalendar :resources="myResources" />
</template>

Both FullCalendar and Mobiscroll use similar structures for defining resources, typically including an id and a label-like field. In FullCalendar this is usually title, while in Mobiscroll it is usually name in the resources array. Like FullCalendar’s resource objects, Mobiscroll also supports a wide range of additional properties, as demonstrated in this example.

For more advanced use cases, refer to the Mobiscroll documentation for additional options, including custom rendering and templating of resources. You can also explore our demo page for detailed resource configuration examples.

Compared to FullCalendar, Mobiscroll provides a more resource-focused user experience, including features such as fixed rows, reordering, and external drag-and-drop.

Event migration​

FullCalendar defines an event inside the events option using explicit start and end values, together with fields like title, allDay, and extendedProps. Mobiscroll uses the data option and explicit start and end properties for defining the event period.

Event structure comparison​

FullCalendar:​

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import resourceTimelinePlugin from '@fullcalendar/resource-timeline'

const calendarOptions = {
  schedulerLicenseKey: 'YOUR_LICENSE_KEY',
  plugins: [resourceTimelinePlugin],
  initialView: 'resourceTimelineDay',
  events: [
    {
      id: '1',
      resourceId: 'r1',
      start: '2017-01-01T10:00:00',
      end: '2017-01-01T12:00:00',
      title: 'Click me'
    }
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll:​

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([
  {
    id: '1',
    resource: 'r1',
    start: '2017-01-01T10:00',
    end: '2017-01-01T12:00',
    title: 'Click me'
  }
])
</script>

<template>
  <MbscEventcalendar :data="myEvents" />
</template>

Converting FullCalendar events to Mobiscroll format​

Here’s a simple example of how to convert FullCalendar-style events into the format used by Mobiscroll:

import { ref } from 'vue'

const mobiscrollEvents = ref([])

// ...

if (fullcalendarEvents && fullcalendarEvents.length) {
  mobiscrollEvents.value = fullcalendarEvents.map(({ resourceId, resourceIds, ...event }) => ({
    ...event,
    resource: resourceId || resourceIds
  }))
}

Every project may have its own unique data format and requirements, so this script serves only as a basic starting point. You’ll likely need to adapt your transformation logic to fit your application’s specific needs.

Loading and saving data​

When selecting a scheduling or calendar UI component, one of the most important factors to evaluate is how the component loads and saves data. The chosen approach can significantly influence performance, scalability, and integration complexity.

We will examine how each framework handles:

  • Loading data from local or remote sources.
  • Saving or synchronizing changes to a backend system.

Loading data​

FullCalendar:

  • FullCalendar accepts local arrays through the events option.
  • It can also load data from JSON feeds or from an events callback function, which receives the visible date range and lets you fetch only the events needed for the current view.
  • If needed, you can refresh remote sources programmatically with refetchEvents().

Mobiscroll:

Let’s see an example for each case:

Local data​

FullCalendar:​

You can pass the event data inline through the events option.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [timeGridPlugin],
  initialView: 'timeGridWeek',
  events: [
    {
      id: '1',
      resourceId: 'r1',
      start: '2017-01-01T10:00:00',
      end: '2017-01-01T12:00:00',
      title: 'Click me'
    }
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll:​

Pass the event array to the data option.

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([
  {
    id: '1',
    resource: 'r1',
    start: '2017-01-01T10:00',
    end: '2017-01-01T12:00',
    title: 'Click me'
  }
])
</script>

<template>
  <MbscEventcalendar :data="myEvents" />
</template>

Remote data​

FullCalendar​

FullCalendar can fetch remote data through an events function or by using a JSON feed URL. The callback receives the currently visible date range, which makes it suitable for loading only the events that belong to the active view.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [timeGridPlugin],
  initialView: 'timeGridWeek',
  events: (fetchInfo, successCallback, failureCallback) => {
    fetch(`/api/events?start=${fetchInfo.startStr}&end=${fetchInfo.endStr}`)
      .then((response) => response.json())
      .then((events) => successCallback(events))
      .catch((error) => failureCallback(error))
  }
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

You can load the data through an external request and assign it to the data-bound variable to update the event calendar with the newly received data.

In case of Mobiscroll, you can also use the page-loading event to load the data on demand for the currently active view. The event fires every time the date range of the view changes, for example, when someone navigates the event calendar.

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar, getJson } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([])

const myView = {
  schedule: { type: 'day' }
}

function handlePageLoading(args) {
  const year = args.month.getFullYear()
  const month = args.month.getMonth()
  const day = args.month.getDate()

  getJson(
    'https://example.remotedata.com/weeklyevents/?year=' + year + '&month=' + month + '&day=' + day,
    (data) => {
      myEvents.value = data
    },
    'jsonp'
  )
}
</script>

<template>
  <MbscEventcalendar
    :view="myView"
    :data="myEvents"
    @page-loading="handlePageLoading"
  />
</template>

In case of the timeline view, data can also be loaded dynamically during scrolling. Scrolling vertically or horizontally triggers the virtual-loading lifecycle event, which can be used to load data incrementally during scrolling.

Saving data​

FullCalendar​

  • Persistence in FullCalendar is typically implemented by listening to lifecycle callbacks and sending the relevant changes to your backend API.
  • Typical hooks include eventAdd, eventChange, and eventRemove.
  • This gives you full control over how changes are saved, but the data layer must be implemented by your application.

Example:

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import interactionPlugin from '@fullcalendar/interaction'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [interactionPlugin, timeGridPlugin],
  initialView: 'timeGridWeek',
  editable: true,
  events: [],
  eventAdd: async ({ event }) => {
    await fetch('/api/events', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(event.toPlainObject())
    })
  },
  eventChange: async ({ event }) => {
    await fetch(`/api/events/${event.id}`, {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(event.toPlainObject())
    })
  },
  eventRemove: async ({ event }) => {
    await fetch(`/api/events/${event.id}`, {
      method: 'DELETE'
    })
  }
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

  • Persistence is managed by listening to Mobiscroll’s CRUD lifecycle events.
  • The Event Calendar exposes a variety of events that are triggered on certain actions made on calendar events. These events can be used to send your data to your API or save it to persistent storage.

Example for saving, updating, and deleting an event through an API:

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([])

const myView = {
  schedule: { type: 'week' }
}

function saveEvent(args) {
  fetch('add.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(args.event)
  })
}

function updateEvent(args) {
  fetch('update.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(args.event)
  })
}

function deleteEvent(args) {
  fetch('delete.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(args.event)
  })
}
</script>

<template>
  <MbscEventcalendar
    :view="myView"
    :data="myEvents"
    @event-created="saveEvent"
    @event-updated="updateEvent"
    @event-deleted="deleteEvent"
  />
</template>

Mobiscroll offers a flexible, event-driven approach suitable for both lightweight client-side setups and API-driven applications. Developers are responsible for implementing their own persistence logic, allowing for high adaptability but requiring more manual integration effort.

Both libraries are capable of handling modern scheduling needs, but the choice depends largely on application scale, data complexity, and desired control over the persistence layer.

Lifecycle events​

Both libraries, FullCalendar and Mobiscroll, provide a comprehensive set of lifecycle event hooks, enabling deep customization and integration with your application logic. These events are emitted at various stages of a component’s lifecycle, offering developers full control to inject custom behavior and extend default functionality.

Whether you’re looking to manipulate data before rendering, respond to user interactions, or perform cleanup tasks, Mobiscroll’s event system offers the flexibility to tailor components to your specific needs.

When migrating between FullCalendar and Mobiscroll, it’s important to note that many lifecycle events follow similar patterns across both libraries. One such example is how each library handles event updates.

FullCalendar​

In FullCalendar, the eventChange callback is triggered after an event has been modified, for example after a drag, resize, or programmatic update. The callback provides access to the updated event, the previous version, related events, and a revert function.

Example:

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import interactionPlugin from '@fullcalendar/interaction'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [interactionPlugin, timeGridPlugin],
  initialView: 'timeGridWeek',
  editable: true,
  events: [],
  eventChange: (changeInfo) => {
    console.log('Event changed:', changeInfo.event)
    // changeInfo.oldEvent contains the previous state
    // changeInfo.revert() can be used if saving fails
  }
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

Mobiscroll components (e.g., Event Calendar, Scheduler, Timeline) expose a similar event-updated event, which is fired when an event is edited. It includes contextual information that allows for granular control over the interaction.

Example:

<script setup>
import { ref } from 'vue'
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([])

function handleEventUpdated(args) {
  console.log('Event updated:', args.event)
}
</script>

<template>
  <MbscEventcalendar
    :data="myEvents"
    @event-updated="handleEventUpdated"
  />
</template>

Although the naming conventions and parameter structures differ between FullCalendar and Mobiscroll, many common integration scenarios can be implemented in both libraries. During migration, each event handler should be validated separately to account for differences in payload structure, lifecycle timing, and supported behaviors.

To explore the full list of available Mobiscroll lifecycle events and understand how they can be leveraged, please refer to the documentation.

Additionally, you can see these events in action through live, interactive examples for the following Mobiscroll components:

These examples provide hands-on insights into how lifecycle events work in practice.

Feature migration​

As a final step, let’s explore how core features from FullCalendar can be replicated using Mobiscroll. While some capabilities are available out of the box in FullCalendar, Mobiscroll often requires more explicit setup but offers much more flexibility across touch and desktop interactions.

Drag & Drop functionality​

FullCalendar:​

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import interactionPlugin from '@fullcalendar/interaction'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [interactionPlugin, timeGridPlugin],
  initialView: 'timeGridWeek',
  editable: true,
  selectable: true
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll:​

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'
</script>

<template>
  <MbscEventcalendar
    :clickToCreate="true"
    :dragToCreate="true"
    :dragToMove="true"
    :dragToResize="true"
    :eventDelete="true"
  />
</template>

This configuration allows users to create, move, resize, and delete events in Mobiscroll.

Switching Views (Calendar/Scheduler/Agenda)​

  • FullCalendar includes a built-in header toolbar. You can switch between views by declaring them in headerToolbar. An object can be supplied with properties start/center/end or left/center/right. These properties contain strings with comma/space separated values. Values separated by a comma will be displayed adjacently. Values separated by a space will be displayed with a small gap in between.
  • Mobiscroll doesn’t include a built-in view-switching UI by default. However, it offers greater flexibility by allowing you to implement a custom header where you can design the view-switching experience to fit your needs. For example, you can use a dropdown menu or segmented controls to let users switch between views like Calendar, Scheduler, Agenda, or any other layout that fits your use case.

FullCalendar:​

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import dayGridPlugin from '@fullcalendar/daygrid'
import listPlugin from '@fullcalendar/list'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [dayGridPlugin, timeGridPlugin, listPlugin],
  initialView: 'timeGridWeek',
  initialDate: '2020-09-12',
  headerToolbar: {
    left: 'title',
    center: 'dayGridMonth,timeGridWeek,timeGridDay,listWeek',
    right: 'prev,today,next'
  }
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll:​

In Mobiscroll, switching between views like Day, Week, or Month requires setting up a custom header along with event listeners to handle the view changes. You can see an example of this implementation here.

<script setup>
import { onMounted, ref } from 'vue'
import {
  getJson,
  MbscCalendarNav,
  MbscCalendarNext,
  MbscCalendarPrev,
  MbscCalendarToday,
  MbscEventcalendar,
  MbscSegmented,
  MbscSegmentedGroup
} from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myEvents = ref([])
const view = ref('month')
const myView = ref({
  calendar: {
    labels: true
  }
})

function changeView() {
  let calView

  switch (view.value) {
    case 'year':
      calView = {
        calendar: { type: 'year' }
      }
      break
    case 'month':
      calView = {
        calendar: { labels: true }
      }
      break
    case 'week':
      calView = {
        schedule: { type: 'week' }
      }
      break
    case 'day':
      calView = {
        schedule: { type: 'day' }
      }
      break
    case 'agenda':
      calView = {
        calendar: { type: 'week' },
        agenda: { type: 'week' }
      }
      break
  }

  myView.value = calView
}

onMounted(() => {
  getJson(
    'https://trial.mobiscroll.com/events/?vers=5',
    (events) => {
      myEvents.value = events
    },
    'jsonp'
  )
})
</script>

<template>
  <MbscEventcalendar
    class="md-switching-view-cont"
    :view="myView"
    :data="myEvents"
    :height="750"
  >
    <template #header>
      <MbscCalendarNav class="cal-header-nav" />
      <div class="cal-header-picker">
        <MbscSegmentedGroup v-model="view" @change="changeView">
          <MbscSegmented value="year"> Year </MbscSegmented>
          <MbscSegmented value="month"> Month </MbscSegmented>
          <MbscSegmented value="week"> Week </MbscSegmented>
          <MbscSegmented value="day"> Day </MbscSegmented>
          <MbscSegmented value="agenda"> Agenda </MbscSegmented>
        </MbscSegmentedGroup>
      </div>
      <MbscCalendarPrev class="cal-header-prev" />
      <MbscCalendarToday class="cal-header-today" />
      <MbscCalendarNext class="cal-header-next" />
    </template>
  </MbscEventcalendar>
</template>

Timezones​

Handling time zones correctly is essential in calendar and scheduling applications, especially when users work across multiple regions. Both FullCalendar and Mobiscroll support timezone-related workflows, but they do so through different configuration models and plugin integrations.

FullCalendar​

FullCalendar supports local, UTC, and named time zones through the timeZone option. Using UTC ensures consistent cross-browser display. Named time zones are also supported, but depending on the setup they may require a timezone implementation.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import timeGridPlugin from '@fullcalendar/timegrid'
import momentTimezonePlugin from '@fullcalendar/moment-timezone'

const calendarOptions = {
  plugins: [timeGridPlugin, momentTimezonePlugin],
  initialView: 'timeGridWeek',
  timeZone: 'Europe/Stockholm',
  events: [
    {
      id: '1',
      title: 'Meeting',
      start: '2025-08-27T09:00:00Z',
      end: '2025-08-27T11:00:00Z'
    }
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

By default, Mobiscroll will not do any timezone conversion and will display the dates without modification, handling them as timezone-less. If your use case requires interpreting or displaying data in a different time zone, you can achieve this by using one of the supported third-party libraries for time zone conversion:

Mobiscroll exposes two configuration options to handle time zones:

  • dataTimezone option - the time zone in which your event data is stored (e.g., 'utc')
  • displayTimezone option - the time zone in which you want the data to be presented (e.g., 'Europe/Stockholm')

So, let’s say you want to use the Day.js timezone library. After installing it into your project, you can pass the dayjsTimezone object to the Event Calendar’s timezonePlugin option:

<script setup>
import dayjs from 'dayjs'
import timezone from 'dayjs/plugin/timezone'
import utc from 'dayjs/plugin/utc'
import { dayjsTimezone, MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

dayjs.extend(utc)
dayjs.extend(timezone)
dayjsTimezone.dayjs = dayjs
</script>

<template>
  <MbscEventcalendar
    :timezonePlugin="dayjsTimezone"
    dataTimezone="utc"
    displayTimezone="Europe/Stockholm"
  />
</template>

Also, feel free to explore live examples to see how time zones work in action:

Or you can also check advanced demos such as:

You can also store the timezone inside the event data, using the timezone property.

Conclusion​

FullCalendar offers a familiar plugin-based API and built-in toolbar-based navigation, while Mobiscroll provides a more unified scheduling product line with highly configurable scheduler and timeline experiences:

In addition to drag & drop and custom view-switching, Mobiscroll also supports timezone handling and zooming levels. All of our views work seamlessly across both mobile and desktop environments, with full support for touch interactions.

As mentioned above, with some additional setup, most - if not all - features can be effectively replicated when migrating from FullCalendar to Mobiscroll. If you have any specific questions or run into any issues, don’t hesitate to reach out - we’re happy to help.

Templating and renderers​

Event templating​

FullCalendar​

FullCalendar customizes event rendering through event render hooks. In Vue projects, eventContent can use Vue slots for custom event content.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import timeGridPlugin from '@fullcalendar/timegrid'

const calendarOptions = {
  plugins: [timeGridPlugin],
  initialView: 'timeGridWeek',
  events: [
    {
      id: '10',
      title: 'Custom Meeting',
      start: '2025-08-27T09:00:00',
      end: '2025-08-27T11:00:00',
      extendedProps: {
        location: 'Room 203'
      }
    }
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions">
    <template #eventContent="arg">
      <div style="background: #a8d8ea; border-radius: 4px; padding: 4px;">
        <strong>{{ arg.event.title }}</strong>
        <div style="font-size: 12px; color: #444;">
          Location: {{ arg.event.extendedProps.location || '' }}
        </div>
      </div>
    </template>
  </FullCalendar>
</template>

Mobiscroll​

You can customize many parts of the Event Calendar by writing custom templates. In the context of Vue these templates are slots. You will find a comprehensive list of all the available slots for the Event Calendar in the API slots section.

When you want to customize how the events look, depending on what your goal is, you have two options:

  • Customize the event content - Mobiscroll takes care of rendering the events in the correct order and also prints basic fields, like start/end, whether it is an allDay event or not and also takes care of coloring the event appropriately. Everything else comes from the custom template.
  • Customize the full event - Mobiscroll takes care of rendering the events in the correct order, but everything else comes from the template you write.

To define a custom template, use the appropriate slot and return the desired markup:

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myView = {
  timeline: {
    type: 'week'
  }
}

const myEvents = [
  {
    id: '10',
    resource: 'r1',
    title: 'Custom Meeting',
    start: '2017-01-01T09:00',
    end: '2017-01-01T11:00',
    location: 'Room 203'
  }
]
</script>

<template>
  <MbscEventcalendar :view="myView" :data="myEvents">
    <template #timelineEvent="event">
      <div style="background: #a8d8ea; border-radius: 4px; padding: 4px;">
        <strong>{{ event.title }}</strong>
        <div style="font-size: 12px; color: #444;">Location: {{ event.original.location }}</div>
      </div>
    </template>
  </MbscEventcalendar>
</template>

Feel free to explore live examples to see how event content templating works in action:

Feel free to explore live examples to see how full event templating works in action:

Resource templating​

FullCalendar​

In FullCalendar, there are two common approaches for customizing the resource area:

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import resourceTimelinePlugin from '@fullcalendar/resource-timeline'

const calendarOptions = {
  schedulerLicenseKey: 'YOUR_LICENSE_KEY',
  plugins: [resourceTimelinePlugin],
  initialView: 'resourceTimelineDay',
  resourceAreaColumns: [
    { field: 'name', headerContent: 'Name' },
    { field: 'city', headerContent: 'City' }
  ],
  resources: [
    { id: '1', title: 'Adam', name: 'Adam', city: 'Washington' },
    { id: '2', title: 'Eva', name: 'Eva', city: 'New York' }
  ]
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

In the case of Mobiscroll, we take a different approach. We provide various templating options, which allow you to customize the resources.

Scheduler​

Use the resource option to customize the resource template of the Scheduler. Customize how the resource headers look and what they show. Utilize properties passed in the resources array.

Check out how you can style the resources in this example.

Timeline​

In case of the Timeline view there are three places where you can customize the resource column:

  • Use the resource option to customize the resource template of the Timeline. Customize how the resource headers look and what they show. Utilize properties passed in the resources array.
  • Customize the empty cell content above the resource column with the resourceHeader option.
  • Or if you want to customize the empty cell content below the resource column you can achieve this with the resourceFooter option. This element only renders for the Timeline view, if the dayFooter option is present.

Check out how you can style these resource parts in this example.

<script setup>
import { MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myView = {
  timeline: {
    type: 'week'
  }
}

const myResources = [
  { id: 1, name: 'Adam', city: 'Washington' },
  { id: 2, name: 'Eva', city: 'New York' }
]
</script>

<template>
  <MbscEventcalendar
    :view="myView"
    :resources="myResources"
  >
    <template #resourceHeader>
      <div class="my-resource-header">
        <strong>Name</strong>
      </div>
      <div class="my-resource-header">
        <i>City</i>
      </div>
    </template>
    <template #resource="resource">
      <div class="my-resource-cell">
        <strong>{{ resource.name }}</strong>
      </div>
      <div class="my-resource-cell">
        <i>{{ resource.city }}</i>
      </div>
    </template>
  </MbscEventcalendar>
</template>

Header templating​

FullCalendar​

FullCalendar comes with a built-in toolbar system through headerToolbar and customButtons. You can reorder, hide, or extend the header, but unlike Mobiscroll, you do not fully template the entire header as markup.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import dayGridPlugin from '@fullcalendar/daygrid'

const calendarOptions = {
  plugins: [dayGridPlugin],
  initialView: 'dayGridMonth',
  customButtons: {
    myButton: {
      text: 'Today +',
      click: () => console.log('Custom button clicked')
    }
  },
  headerToolbar: {
    start: 'title',
    center: '',
    end: 'today prev,next myButton'
  }
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

The header of the Mobiscroll calendar can be fully customized to one's needs with the use of the header option.

Here's the list of the built in components of the default header. You can initialize these by putting the attributes on the elements:

  • mbsc-calendar-prev - Previous button component, that navigates to the previous month.
  • mbsc-calendar-next - Next button component, that navigates to the next month.
  • mbsc-calendar-today - Today button component, that navigates to the current date.
  • mbsc-calendar-nav - The title navigation button component, that opens the year/month navigation.

The following example will render the prev and next buttons and a custom title.

<script setup>
import { MbscCalendarNext, MbscCalendarPrev, MbscEventcalendar } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

const myTitle = 'Awesome title'
</script>

<template>
  <MbscEventcalendar>
    <template #header>
      <MbscCalendarPrev />
      <MbscCalendarNext />
      <div class="my-custom-title">{{ myTitle }}</div>
    </template>
  </MbscEventcalendar>
</template>

Also, feel free to explore live examples to see how header templating works in action:

Other templating/ renderer options​

Event Calendar​

  • Date header templating - There are two approaches you can take:
    • Customize the date headers of the Event Calendar with the day option by adding relevant content, labels or completely change how they look.
    • If you are looking to customize only the content and don't want to bother with the styling of the event, you can use the dayContent option.

Scheduler​

  • Date header templating - There are two approaches you can take:

    • Customize the date headers of the Scheduler with the day option by adding relevant content, labels or completely change how they look.
    • If you are looking to customize only the content and don't want to bother with the styling of the event, you can use the dayContent option.

    Check out how you can style the date header in this example.

Timeline​

  • Templating the sidebar header and footer - Besides the resource template, an additional sidebar can be rendered on the opposite end of the row and there are three approaches you can take:

    • Use the sidebar option to render a custom sidebar on the right side of the Timeline.
    • Customize the empty cell content above the sidebar column with the sidebarHeader option.
    • Or if you want to customize the empty cell content below the sidebar column you can achieve this with the sidebarFooter option.

    Check out how you can style the sidebar parts in this example.

  • Date header and footer templating - The headers hold key information like the date, day of the week and in some cases it also holds the full date. Whenever you need to show extra information, or if you would like to change the styling or date format, time format you can use the various header templates, depending on the view configuration. You can also show a footer element, for displaying more information.

    Check out how you can style the date header and footer in this example.

  • Slots - Use the slot option to customize the slot template of the Timeline view.

    Check out how you can style the slots in this example.

  • Variable event height - When using event templating, you might end up with various event heights, depending on the displayed content, e.g. larger description, list of tasks, etc. You can enable support for variable event heights by setting the eventHeight: 'variable' property for the timeline inside the view option.

    Check out how you can set and style the variable event height in this example.

Agenda​

Localization​

FullCalendar​

FullCalendar supports localization through the locale option. These settings affect button text, month and weekday names, date formatting, week calculations, and the first day of the week.

<script setup>
import FullCalendar from '@fullcalendar/vue3'
import dayGridPlugin from '@fullcalendar/daygrid'
import frLocale from '@fullcalendar/core/locales/fr'

const calendarOptions = {
  plugins: [dayGridPlugin],
  initialView: 'dayGridMonth',
  locale: frLocale
}
</script>

<template>
  <FullCalendar :options="calendarOptions" />
</template>

Mobiscroll​

Mobiscroll enables localization by letting developers set language, date, and time formats both globally and locally on individual components. Highlights:

  • Global settings object lets developers set locale, theme, and format across the app.
  • Each component supports locale switching and custom translations with simple configuration.
  • RTL and calendar system support (Gregorian, Jalali, Hijri).
  • Quick override ability for localized formats ensures that adaptations can be made case-by-case or via global settings.

Example setting the locale option globally:

<script setup>
import { setOptions, localeFr } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'

setOptions({
  locale: localeFr
})
</script>

Example setting the locale at the component level:

<script setup>
import { MbscEventcalendar, localeFr } from '@mobiscroll/vue'
import '@mobiscroll/vue/dist/css/mobiscroll.min.css'
</script>

<template>
  <MbscEventcalendar :locale="localeFr" />
</template>

Conclusion​

For teams building customer-facing schedulers - whether for appointments, reservations, healthcare, or mobile apps - Mobiscroll offers a faster, more focused path to production. It combines a complete feature set with strong performance and specialized UX capabilities like fixed resources and multi-calendar support. Instead of combining multiple FullCalendar plugins and premium add-ons, you get a unified scheduling product line with native Vue components and responsive interactions out of the box.

The overall migration process includes:

  • Adjusting initialization patterns
  • Adapting view configurations
  • Mapping resources and events to Mobiscroll’s structure
  • Enabling features like drag-and-drop manually

With a clear understanding of both libraries’ capabilities and structures, you can migrate efficiently and take full advantage of Mobiscroll’s modern UI and feature-rich environment.

Considering migrating from FullCalendar to Mobiscroll?​

Schedule a call and let's chat about how we can help. We're here to support you in the migration process.