Initialize App

After we have our app layout now we need to mount React components and initialize the app. You can read about all possible Framework7 initialization parameters in appropriate Framework7 App Parameters section.

We have the following HTML structure in our index file:

  1. <!-- index.html -->
  3. <!DOCTYPE html>
  4. <html>
  5.   <head>
  6.     <!-- ... metas and styles ... -->
  7.     <link rel="stylesheet" href="path/to/framework7.bundle.min.css">
  8.   </head>
  9.   <body>
  10.     <!-- App Root Element -->
  11.     <div id="app"></div>
  12.     <script type="text/javascript" src="path/to/app.js"></script>
  13.   </body>
  14. </html>

In addition, if you’re using Create React App, Webpack or Browserify, you might typically have a root-level app.js or index.js file that mounts your root app component:

  1. // app.js
  3. // Import React
  4. import React from  'react';
  6. // Import ReactDOM
  7. import ReactDOM from  'react-dom';
  9. // Import F7 Bundle
  10. import Framework7 from 'framework7/framework7.esm.bundle.js';
  12. // Import F7-React Plugin
  13. import Framework7React from 'framework7-react';
  15. // Init F7-React Plugin
  16. Framework7.use(Framework7React);
  18. // Import Main App component
  19. import App from './App.jsx';
  21. // Mount React App
  22. ReactDOM.render(
  23.   React.createElement(App),
  24.   document.getElementById('app')
  25. )

Your root App.jsx component will typically have a top-level Framework7App component. This component is used to configure your app:

  1. // App.jsx
  3. import { App, View, Page, Navbar, Toolbar, Link } from 'framework7-react';
  4. import routes from './routes.js';
  6. const f7params = {
  7.   // Array with app routes
  8.   routes,
  9.   // App Name
  10.   name: 'My App',
  11.   // App id
  12.   id: 'com.myapp.test',
  13.   // ...
  14. };
  16. export default () => (
  17.   // Main Framework7 App component where we pass Framework7 params
  18.   <App params={f7params}>
  19.     <Statusbar />
  21.     {/* initial page is specified in routes.js */}
  22.     <View main url="/" />
  23.   </App>
  24. )

In the examples above:

  • we pass Framework7 parameters to the App main Framework7 app component in its **params** property;
  • root element passed to ReactDOM.render (document.getElementById('app')) will be used as Framework7 root element

We also must specify array with routes (if we have navigation between pages in the app). Check out information about React Component Extensions, router and routes in the Navigation Router section.