{"id":13506601,"url":"https://github.com/nuxt-community/nuxt7","last_synced_at":"2025-05-16T06:08:15.450Z","repository":{"id":25527478,"uuid":"104254772","full_name":"nuxt-community/nuxt7","owner":"nuxt-community","description":"📱 Full Featured iOS \u0026 Android PWA Apps with Nuxt.js and Framework7","archived":false,"fork":false,"pushed_at":"2025-04-05T16:55:02.000Z","size":2616,"stargazers_count":326,"open_issues_count":29,"forks_count":32,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-08T16:06:45.589Z","etag":null,"topics":["andriod","framework7","framework7io","hybrid","ios","nuxt","nuxtjs","pwa","vue"],"latest_commit_sha":null,"homepage":"https://nuxt7.netlify.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuxt-community.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-20T18:45:06.000Z","updated_at":"2024-12-05T02:29:55.000Z","dependencies_parsed_at":"2023-01-14T07:00:30.748Z","dependency_job_id":"49b5dab1-95bf-4a47-b20e-d0f497f3e018","html_url":"https://github.com/nuxt-community/nuxt7","commit_stats":{"total_commits":283,"total_committers":11,"mean_commits":"25.727272727272727","dds":"0.18021201413427557","last_synced_commit":"90db84f853fc8e18d9fcb2d3b14abd32a0814b13"},"previous_names":[],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuxt-community%2Fnuxt7","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuxt-community%2Fnuxt7/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuxt-community%2Fnuxt7/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuxt-community%2Fnuxt7/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuxt-community","download_url":"https://codeload.github.com/nuxt-community/nuxt7/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478193,"owners_count":22077676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["andriod","framework7","framework7io","hybrid","ios","nuxt","nuxtjs","pwa","vue"],"created_at":"2024-08-01T01:00:54.381Z","updated_at":"2025-05-16T06:08:10.439Z","avatar_url":"https://github.com/nuxt-community.png","language":"TypeScript","funding_links":[],"categories":["Uncategorized","TypeScript","JavaScript"],"sub_categories":["Uncategorized"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/nuxt-community/nuxt7/raw/master/.assets/nuxt7.png\" alt=\"Nuxt7\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://david-dm.org/nuxt-community/nuxt7\"\u003e\n    \u003cimg alt=\"\" src=\"https://david-dm.org/nuxt-community/nuxt7/status.svg?style=flat-square\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://npmjs.com/package/nuxt7\"\u003e\n    \u003cimg alt=\"\" src=\"https://img.shields.io/npm/v/nuxt7/latest.svg?style=flat-square\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://npmjs.com/package/nuxt7\"\u003e\n    \u003cimg alt=\"\" src=\"https://img.shields.io/npm/dt/nuxt7.svg?style=flat-square\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://circleci.com/gh/nuxt-community/nuxt7\"\u003e\n    \u003cimg alt=\"\" src=\"https://img.shields.io/circleci/project/github/nuxt-community/nuxt7/master.svg?style=flat-square\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://standardjs.com\"\u003e\n    \u003cimg alt=\"\" src=\"https://img.shields.io/badge/code_style-standard-brightgreen.svg?style=flat-square\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nFull Featured iOS \u0026 Android \u003cstrong\u003ePWA\u003c/strong\u003e Apps with \u003ca href=\"https://nuxtjs.org\"\u003eNuxt.js\u003c/a\u003e and \u003ca href=\"https://framework7.io\"\u003eFramework7\u003c/a\u003e\n\u003cbr\u003e\n\u003c/p\u003e\n\nNuxt7 integrates universal nuxt.js applications with [Framework7](https://framework7.io/)[-Vue](https://framework7.io/vue)\nto rapidly create efficient and feature-reach [PWA](https://developers.google.com/web/progressive-web-apps) mobile applications with help of [pwa-module](https://github.com/nuxt-community/pwa-module). Production builds can be statically hosted or running offline.\n\n\u003ca href=\"./CHANGELOG.md\"\u003e📖 Release Notes\u003c/a\u003e\n\n## ✨ Features\n\n* Fully compatible with Framework7 5.x\n* Development mode with hot reloading\n* Optimized production builds suitable for 100% static hosting\n* Fully PWA compatible out of the box\n* Page based router for Framework7\n* Use vuex store in your apps\n* Familiar nuxt.js development experience with a super easy learning curve\n\n## ⚔️ Quick Start\n\nUse the command below to create a new app using starter template:\n\n```bash\nnpx sao@1 -u nuxt-community/nuxt7 nuxt7-app\n```\n\n## ▶️ Examples\n\n* [kitchen-sink](./examples/kitchen-sink) - [online version](https://nuxt7.netlify.com)\n* [with-params](./examples/with-params)\n* [routable-tabs](./examples/routable-tabs)\n\nTo locally run each example:\n\n* Clone this repository\n* Install dependencies using `yarn install`\n* Run examples in development mode using `yarn examples/[example name]`\n* Navigate to `http://localhost:3000`\n\n## 🔧 Module options\n\nAdd options in `framework7` section inside `nuxt.config.js` file.\n\n### `app`\n\n- Type: `Object`\n\nDefault:\n\n```js\napp: {\n  theme: 'auto'\n}\n```\n\nFramework7 constructor params. See [App Component](https://framework7.io/vue/app.html) and [App Docs](https://framework7.io/docs/app.html) for all available parameters.\n\n### `main`\n\n- Type: `Object`\n\nDefault:\n\n```js\nmain: {\n    main: true,\n    pushState: true\n}\n```\n\nProps passed to the **main** `\u003cf7-view\u003e`. See [View Component](https://framework7.io/vue/view.html) docs for more info.\n\n### `mode`\n\n- Type: `String`\n- Default: `history`\n\nRouter mode. Can be `hash` or `history`.\n\nThe `history` mode enables SEO friendly routes by setting `main.pushStateSeparator` value to `''`.\n\n### `invertNav`\n\n- Type: `boolean`\n- Default: `true`\n\nInvert navigation bars to fill style.\n\n### `disableContextMenu`\n\n- Type: `boolean`\n- Default: `true`\n\nDisable context menu with long touch. (Recommanded to enable `disableSelect` too)\n\n### `disableSelect`\n\n- Type: `boolean`\n- Default: `true`\n\nDisable selection/copy in UIWebView. (Useful to use with `disableContextMenu`)\n\n### `rtl`\n\n- Type: `boolean`\n- Default: `false`\n\nEnable RTL Layout.\n\n### `themeColor`\n\n- Type: `string`\n- Default: `#007aff` (Dodger Blue)\n\n Primary app color.\n\n### `themes`\n\n- Type: `array`\n- Default: `['ios', 'md']\n\n### `darkTheme`\n\n- Type: `boolean`\n- Default: `true`\n\nEnable darkTheme support.\n\n### `lightTheme`\n\n- Type: `boolean`\n- Default: `true`\n\nEnable lightTheme support.\n\n### `colors`\n\n- Type: `object`\n- Default: See [lib/build-config.js](lib/build-config.js)\n\nApp colors.\n\n### `components`\n\n- Type: `array`\n- Default: See [lib/build-config.js](lib/build-config.js)\n\nEnabled components. (only used for `.less` imports)\n\n### `css`\n\n- Type: `Boolean`\n- Default: `true`\n\nInclude Framework7 styles.\n\n### `customCSS`\n\n- Type: `Boolean`\n- Default: `true`\n\nInclude Nuxt7 custom styles.\n\n\n### `f7Icons`\n\n- Type: `Boolean`\n- Default: `true`\n\nnclude Framework7 Icons (IOS).\n\n### `mdIcons`\n\n- Type: `Boolean`\n- Default: `true`\n\nInclude MD Icons (Android).\n\n### `routes`\n\n- Type: `Boolean`\n- Default: `true`\n\nRoutes are auto generated using pages directory structure.\nHowever if you need to make more customization (Like adding routable tabs) this option may be used.\n\nExample: (**nuxt.config.js**)\n\n```js\nframework7: {\n    routes: {\n      'tabs-routable': {\n        tabs: [\n          { path: \"/\", id: \"tab1\" },\n          { path: \"/tab2/\", id: \"tab2\" },\n          { path: \"/tab3/\", id: \"tab3\" },\n        ]\n      }\n    }\n}\n```\n\nPlease see [examples/routable-tabs](./examples/routable-tabs) for a working example.\n\n## 🤔 Common Questions\n\n**Can i use this module for my existing nuxt project?**\n\nNo. It is highly recommanded to use a standalone project for mobile app.\n\n**Why `asyncData`/middleware is not working?**\n\nFramework7Vue has it's own router. You can define state in `data()` and use `async mounted` to fill the state.\n\nMiddleware also don't work. You can use nuxt plugins instead. (ServerMiddleware are supported in server mode)\n\n**How to deploy?**\n\nNuxt7 is designed to make a fully functional PWA app. Users can install app using \"Add to Homescreen\".\n\n- Use `nuxt generate` to make a static version\n- Deploy it on your own server or use free services, [now](https://zeit.co/now) or [netlify](https://www.netlify.com) or [surge](https://surge.sh)\n\n**How to make sidepanel working?**\n\nThe `default` layout can do the trick. See [kitchen-sink/layouts/default.vue](examples/kitchen-sink/layouts/default.vue) for an example.\n\n**How to create default 404 route?**\n\nCreate `pages/default.vue` file. It will be used as fallback route.\n\n## 🍳 Development\n\n```bash\n# Fork and clone git@github.com:nuxt-community/nuxt7.git\n\n# Install dependencies\nyarn install\n\n# Start development server (kitchen sink)\nyarn dev\n```\n\n## License\n\nMIT - Nuxt Community - Pooya Parsa\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuxt-community%2Fnuxt7","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuxt-community%2Fnuxt7","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuxt-community%2Fnuxt7/lists"}