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 React. 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 React through its official <FullCalendar /> component, while Mobiscroll provides native React components that plug directly into JSX through standard bindings.

If you are currently using FullCalendar in React and planning to migrate to Mobiscroll’s React 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 react

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:​

import FullCalendar from '@fullcalendar/react';
import dayGridPlugin from '@fullcalendar/daygrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[dayGridPlugin]}
      initialView="dayGridMonth"
    />
  );
}

Mobiscroll:​

import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/mobiscroll.min.css';

function App() {
  return (
    <Eventcalendar />
  );
}

export default App;

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.

import FullCalendar from '@fullcalendar/react';
import resourceTimelinePlugin from '@fullcalendar/resource-timeline';

export default function App() {
  return (
    <FullCalendar
      schedulerLicenseKey="YOUR_LICENSE_KEY"
      plugins={[resourceTimelinePlugin]}
      initialView="resourceTimelineDay"
      initialDate="2017-01-01"
      slotMinTime="06:00:00"
      slotMaxTime="20:00:00"
    />
  );
}

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.

import { useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const myView = useMemo(
    () => ({
      timeline: {
        type: 'day',
        size: 1,
        startTime: '06:00',
        endTime: '20:00',
      },
    }),
    [],
  );

  return (
    <Eventcalendar
      view={myView}
      defaultSelectedDate="2017-01-01"
    />
  );
}

export default App;

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 need to be specified with the initialView. You choose the initial date with initialDate.

import FullCalendar from '@fullcalendar/react';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[timeGridPlugin]}
      initialView="timeGridWeek"
      initialDate="2020-09-12"
    />
  );
}

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.

import { useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const myView = useMemo(
    () => ({
      schedule: {
        type: 'week',
      },
    }),
    [],
  );

  return (
    <Eventcalendar
      view={myView}
      defaultSelectedDate="2020-09-12"
    />
  );
}

export default App;

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:​

const myResources = [
  { id: 'r1', title: 'Mike' },
  { id: 'r2', title: 'Linda' },
  // ...
];

Mobiscroll Timeline view/ Scheduler - resource definition:​

import { useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const myResources = useMemo(
    () => [
      { id: 'r1', name: 'Mike' },
      { id: 'r2', name: 'Linda' },
      // ...
    ],
    [],
  );

  return (
    <Eventcalendar
      resources={myResources}
    />
  );
}

export default App;

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:​

const myEvents = [
  {
    id: '1',
    resourceId: 'r1',
    start: '2017-01-01T10:00:00',
    end: '2017-01-01T12:00:00',
    title: 'Click me',
  },
];

Mobiscroll:​

import { useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const myEvents = useMemo(
    () => [
      {
        id: '1',
        resource: 'r1',
        start: '2017-01-01T10:00',
        end: '2017-01-01T12:00',
        title: 'Click me',
      },
    ],
    [],
  );

  return (
    <Eventcalendar
      data={myEvents}
    />
  );
}

export default App;

Converting FullCalendar events to Mobiscroll format​

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

const mobiscrollEvents = 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.

import FullCalendar from '@fullcalendar/react';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[timeGridPlugin]}
      initialView="timeGridWeek"
      events={[
        {
          id: '1',
          resourceId: 'r1',
          start: '2017-01-01T10:00:00',
          end: '2017-01-01T12:00:00',
          title: 'Click me',
        },
      ]}
    />
  );
}

Mobiscroll:​

Pass the event array to the data option.

import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

const myData = [
  {
    id: '1',
    resource: 'r1',
    start: '2017-01-01T10:00',
    end: '2017-01-01T12:00',
    title: 'Click me',
  },
];

function App() {
  return <Eventcalendar data={myData} />;
}

export default App;

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.

import FullCalendar from '@fullcalendar/react';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      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));
      }}
    />
  );
}

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 onPageLoading 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.

import { useCallback, useState } from 'react';
import { Eventcalendar, getJson } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

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

function App() {
  const [myEvents, setEvents] = useState([]);

  const handlePageLoading = useCallback((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) => {
        setEvents(data);
      },
      'jsonp',
    );
  }, []);

  return (
    <Eventcalendar
      data={myEvents}
      onPageLoading={handlePageLoading}
      view={myView}
    />
  );
}

export default App;

In case of the timeline view, data can also be loaded dynamically during scrolling. Scrolling vertically or horizontally triggers the onVirtualLoading 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:

import FullCalendar from '@fullcalendar/react';
import interactionPlugin from '@fullcalendar/interaction';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App({ events }) {
  return (
    <FullCalendar
      plugins={[interactionPlugin, timeGridPlugin]}
      initialView="timeGridWeek"
      editable={true}
      events={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',
        });
      }}
    />
  );
}

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:

import { useCallback, useState } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

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

function App() {
  const [myEvents] = useState([]);

  const saveEvent = useCallback((args) => {
    fetch('add.php', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(args.event),
    });
  }, []);

  const updateEvent = useCallback((args) => {
    fetch('update.php', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(args.event),
    });
  }, []);

  const deleteEvent = useCallback((args) => {
    fetch('delete.php', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(args.event),
    });
  }, []);

  return (
    <Eventcalendar
      view={myView}
      onEventCreated={saveEvent}
      onEventUpdated={updateEvent}
      onEventDeleted={deleteEvent}
      data={myEvents}
    />
  );
}

export default App;

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:

import FullCalendar from '@fullcalendar/react';
import interactionPlugin from '@fullcalendar/interaction';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App({ events }) {
  return (
    <FullCalendar
      plugins={[interactionPlugin, timeGridPlugin]}
      initialView="timeGridWeek"
      editable={true}
      events={events}
      eventChange={(changeInfo) => {
        console.log('Event changed:', changeInfo.event);
        // changeInfo.oldEvent contains the previous state
        // changeInfo.revert() can be used if saving fails
      }}
    />
  );
}

Mobiscroll​

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

Example:

import { useState } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const [myEvents] = useState([]);

  const handleEventUpdated = (args) => {
    console.log('Event updated:', args.event);
  };

  return (
    <Eventcalendar
      data={myEvents}
      onEventUpdated={handleEventUpdated}
    />
  );
}

export default App;

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:​

import FullCalendar from '@fullcalendar/react';
import interactionPlugin from '@fullcalendar/interaction';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[interactionPlugin, timeGridPlugin]}
      initialView="timeGridWeek"
      editable={true}
      selectable={true}
    />
  );
}

Mobiscroll:​

import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  return (
    <Eventcalendar
      clickToCreate={true}
      dragToCreate={true}
      dragToMove={true}
      dragToResize={true}
      eventDelete={true}
    />
  );
}

export default App;

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:​

import FullCalendar from '@fullcalendar/react';
import dayGridPlugin from '@fullcalendar/daygrid';
import listPlugin from '@fullcalendar/list';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[dayGridPlugin, timeGridPlugin, listPlugin]}
      initialView="timeGridWeek"
      initialDate="2020-09-12"
      headerToolbar={{
        left: 'title',
        center: 'dayGridMonth,timeGridWeek,timeGridDay,listWeek',
        right: 'prev,today,next',
      }}
    />
  );
}

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.

import { useCallback, useEffect, useState } from 'react';
import {
  CalendarNav,
  CalendarNext,
  CalendarPrev,
  CalendarToday,
  Eventcalendar,
  getJson,
  Segmented,
  SegmentedGroup,
} from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

function App() {
  const [view, setView] = useState('month');
  const [myEvents, setEvents] = useState([]);

  const [calView, setCalView] = useState({
    calendar: { labels: true },
  });

  const changeView = useCallback((event) => {
    let nextView;

    switch (event.target.value) {
      case 'year':
        nextView = {
          calendar: { type: 'year' },
        };
        break;
      case 'month':
        nextView = {
          calendar: { labels: true },
        };
        break;
      case 'week':
        nextView = {
          schedule: { type: 'week' },
        };
        break;
      case 'day':
        nextView = {
          schedule: { type: 'day' },
        };
        break;
      case 'agenda':
        nextView = {
          calendar: { type: 'week' },
          agenda: { type: 'week' },
        };
        break;
      default:
        nextView = {
          calendar: { labels: true },
        };
        break;
    }

    setView(event.target.value);
    setCalView(nextView);
  }, []);

  const customWithNavButtons = useCallback(
    () => (
      <>
        <CalendarNav className="cal-header-nav" />
        <div className="cal-header-picker">
          <SegmentedGroup value={view} onChange={changeView}>
            <Segmented value="year">Year</Segmented>
            <Segmented value="month">Month</Segmented>
            <Segmented value="week">Week</Segmented>
            <Segmented value="day">Day</Segmented>
            <Segmented value="agenda">Agenda</Segmented>
          </SegmentedGroup>
        </div>
        <CalendarPrev className="cal-header-prev" />
        <CalendarToday className="cal-header-today" />
        <CalendarNext className="cal-header-next" />
      </>
    ),
    [changeView, view],
  );

  useEffect(() => {
    getJson(
      'https://trial.mobiscroll.com/events/?vers=5',
      (events) => {
        setEvents(events);
      },
      'jsonp',
    );
  }, []);

  return (
    <Eventcalendar
      clickToCreate={true}
      dragToCreate={true}
      dragToMove={true}
      dragToResize={true}
      eventDelete={true}
      renderHeader={customWithNavButtons}
      height={750}
      view={calView}
      data={myEvents}
      cssClass="md-switching-view-cont"
    />
  );
}

export default App;

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.

import FullCalendar from '@fullcalendar/react';
import timeGridPlugin from '@fullcalendar/timegrid';
import momentTimezonePlugin from '@fullcalendar/moment-timezone';

export default function App() {
  return (
    <FullCalendar
      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',
        },
      ]}
    />
  );
}

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:

import dayjs from 'dayjs';
import timezone from 'dayjs/plugin/timezone';
import utc from 'dayjs/plugin/utc';
import { Eventcalendar, dayjsTimezone } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

dayjs.extend(utc);
dayjs.extend(timezone);
dayjsTimezone.dayjs = dayjs;

function App() {
  return (
    <Eventcalendar
      timezonePlugin={dayjsTimezone}
      dataTimezone="utc"
      displayTimezone="Europe/Stockholm"
    />
  );
}

export default App;

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 React projects, eventContent can return JSX directly.

import FullCalendar from '@fullcalendar/react';
import timeGridPlugin from '@fullcalendar/timegrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[timeGridPlugin]}
      initialView="timeGridWeek"
      eventContent={(arg) => (
        <div style={{ background: '#a8d8ea', borderRadius: '4px', padding: '4px' }}>
          <strong>{arg.event.title}</strong>
          <div style={{ fontSize: '12px', color: '#444' }}>
            Location: {arg.event.extendedProps.location || ''}
          </div>
        </div>
      )}
      events={[
        {
          id: '10',
          title: 'Custom Meeting',
          start: '2025-08-27T09:00:00',
          end: '2025-08-27T11:00:00',
          extendedProps: {
            location: 'Room 203',
          },
        },
      ]}
    />
  );
}

Mobiscroll​

You can customize many parts of the Event Calendar by writing custom templates. In the context of plain React these templates are functions that return JSX. You will find a comprehensive list of all the available render functions for the Event Calendar in the API templates 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, pass a function to the appropriate option that returns the desired JSX:

import { useCallback, useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

const App = () => {
  const myView = useMemo(
    () => ({
      timeline: {
        type: 'week',
      },
    }),
    [],
  );

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

  const customEventRenderer = useCallback((event) => {
    return (
      <div style={{ background: '#a8d8ea', borderRadius: '4px', padding: '4px' }}>
        <strong>{event.title}</strong>
        <div style={{ fontSize: '12px', color: '#444' }}>
          Location: {event.original.location}
        </div>
      </div>
    );
  }, []);

  return (
    <Eventcalendar
      view={myView}
      data={myEvents}
      renderScheduleEvent={customEventRenderer}
    />
  );
};

export default App;

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:

import FullCalendar from '@fullcalendar/react';
import resourceTimelinePlugin from '@fullcalendar/resource-timeline';

export default function App() {
  return (
    <FullCalendar
      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' },
      ]}
    />
  );
}

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 renderResource 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 renderResource 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 renderResourceHeader option.
  • Or if you want to customize the empty cell content below the resource column you can achieve this with the renderResourceFooter option. This element only renders for the Timeline view, if the renderDayFooter option is present.

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

import { useCallback, useMemo } from 'react';
import { Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

const App = () => {
  const myView = useMemo(
    () => ({
      timeline: {
        type: 'week',
      },
    }),
    [],
  );

  const myResources = useMemo(
    () => [
      { id: 1, name: 'Adam', city: 'Washington' },
      { id: 2, name: 'Eva', city: 'New York' },
    ],
    [],
  );

  const renderResourceHeader = useCallback(() => (
    <>
      <div className="my-resource-header">
        <strong>Name</strong>
      </div>
      <div className="my-resource-header">
        <i>City</i>
      </div>
    </>
  ), []);

  const renderResource = useCallback((resource) => (
    <>
      <div className="my-resource-cell">
        <strong>{resource.name}</strong>
      </div>
      <div className="my-resource-cell">
        <i>{resource.city}</i>
      </div>
    </>
  ), []);

  return (
    <Eventcalendar
      view={myView}
      resources={myResources}
      renderResource={renderResource}
      renderResourceHeader={renderResourceHeader}
    />
  );
};

export default App;

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.

import FullCalendar from '@fullcalendar/react';
import dayGridPlugin from '@fullcalendar/daygrid';

export default function App() {
  return (
    <FullCalendar
      plugins={[dayGridPlugin]}
      initialView="dayGridMonth"
      customButtons={{
        myButton: {
          text: 'Today +',
          click: () => console.log('Custom button clicked'),
        },
      }}
      headerToolbar={{
        start: 'title',
        center: '',
        end: 'today prev,next myButton',
      }}
    />
  );
}

Mobiscroll​

The header of the Mobiscroll calendar can be fully customized to one's needs with the use of the renderHeader 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.

import { CalendarNext, CalendarPrev, Eventcalendar } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

const myTitle = 'Awesome title';

const myHeader = () => {
  return (
    <>
      <CalendarPrev />
      <CalendarNext />
      <div className="my-custom-title">{myTitle}</div>
    </>
  );
};

function App() {
  return <Eventcalendar renderHeader={myHeader} />;
}

export default App;

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 renderDay 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 renderDayContent option.

Scheduler​

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

    • Customize the date headers of the Scheduler with the renderDay 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 renderDayContent 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 renderSidebar option to render a custom sidebar on the right side of the Timeline.
    • Customize the empty cell content above the sidebar column with the renderSidebarHeader option.
    • Or if you want to customize the empty cell content below the sidebar column you can achieve this with the renderSidebarFooter 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 renderSlot 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.

import FullCalendar from '@fullcalendar/react';
import dayGridPlugin from '@fullcalendar/daygrid';
import frLocale from '@fullcalendar/core/locales/fr';

export default function App() {
  return (
    <FullCalendar
      plugins={[dayGridPlugin]}
      initialView="dayGridMonth"
      locale={frLocale}
    />
  );
}

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:

import { setOptions, localeFr } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

setOptions({
  locale: localeFr,
});

Example setting the locale at the component level:

import { Eventcalendar, localeFr } from '@mobiscroll/react';
import '@mobiscroll/react/dist/css/mobiscroll.min.css';

export function MyComponent() {
  return <Eventcalendar locale={localeFr} />;
}

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 React 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.