Skip to content

Framework7 Mobile App Introduction

Start a Framework7 8 mobile project in Wappler and understand the app shell, routed pages, App Connect bindings, and Capacitor handoff.

Framework7 starts in a Mobile project

Framework7 coverage in Wappler belongs to the Mobile project workflow. Create or open a Mobile project first, then use Framework7 8 for the native-style interface and Capacitor for the device runtime. This tour opens the auto-installed Demo Framework7 Kitchen Sink so every concept is visible in a complete mobile project.

Mobile project
Provides the app project structure, www root, routing, and platform workflow.
Framework7 8
Provides the mobile shell, pages, navigation, lists, cards, dialogs, and interaction patterns.
Capacitor
Packages the web project for device targets and connects native APIs.

Open the current Framework7 8 mobile shell

The demo home page is a real Wappler mobile page. It combines the dmx-f7-app root, panels, a main view, a page, navbar, searchable component catalog, routed content, App Connect, and Capacitor examples.

Choose the Mobile starter that matches the interface

In Project Manager, New Project → Mobile offers Framework7 Blank and Bootstrap Blank. Choose Framework7 Blank for a native-style Framework7 shell. Choose Bootstrap Blank when the app should use Bootstrap 5 and App Connect routing. Both are Mobile projects and use Capacitor as the app runtime.

Mobile starter Use it for Routing
Framework7 BlankiOS/Android-style navigation, views, panels, sheets, dialogs, lists, and Framework7 componentsFramework7 routes in /js/routes.js
Bootstrap BlankBootstrap 5 layouts and components in a mobile app shellApp Connect routes in /js/routes.js

Read the Framework7 shell from the outside in

The hierarchy is deliberate. dmx-f7-app owns the Framework7 application. Views own navigation stacks. A page owns the navbar, toolbar, and scrollable page-content. Panels and temporary views sit beside the main view so they can open without replacing the current route.

Layer Responsibility
dmx-f7-appInitializes the Framework7 application inside App Connect
view-mainOwns the primary navigation history and route outlet
pageRepresents one navigable mobile screen
navbar / toolbarKeeps screen navigation and primary actions consistent
page-contentProvides the scrollable content area for components
panel / popup / sheetProvides secondary or temporary UI without losing the current page

The main view is the navigation anchor

This selection highlights the real main view. Its data-url starts the first route, while its nested page provides the initial visible screen. Add global shell UI around routed content only when it truly belongs on every screen.

Framework7 presentation and App Connect state work together

Framework7 supplies the mobile presentation and navigation behavior. App Connect supplies data, expressions, repeats, dynamic attributes, events, server calls, and client flows. Keep those jobs distinct: build the mobile surface with Framework7 components, then bind it to state and business logic with App Connect.

Use Framework7 classes and components for mobile structure and interaction
Use App Connect values, repeats, expressions, and events for reactive behavior
Use routed content pages for screen-to-screen navigation
Use Capacitor components and Flow actions only when the app needs device capabilities

Design View proves the UI; a target device proves native behavior

Design View is the fast loop for layout, routes, bindings, and web-compatible interactions. Camera, native permissions, deep links, device information, and other platform APIs must also be tested through the Capacitor platform workflow on the intended target.

IMPORTANT: A page that looks correct in Design View is not yet proof that native permissions, lifecycle events, or hardware APIs work on every target.

Continue through the complete mobile path

The next tour moves from the shell into the complete Framework7 component workflow. You can also jump directly to routing, Capacitor setup, Bootstrap 5 mobile routing, or desktop app setup.