Skip to content

Commit 05f6530

Browse files
committed
docs(guide): update versioned overviews for angular and vue
1 parent aa8c2e6 commit 05f6530

File tree

6 files changed

+91
-67
lines changed

6 files changed

+91
-67
lines changed

docs/angular/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ import DocsCards from '@components/global/DocsCards';
1818

1919
## Angular Version Support
2020

21-
Ionic Angular supports the latest versions of Angular. For detailed information on supported versions and our support policy, see the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular).
21+
Ionic Angular v8 supports Angular versions 16 and above. For detailed information on supported versions and our support policy, see the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular).
2222

2323
## Angular Tooling
2424

@@ -54,7 +54,7 @@ $ ionic serve █
5454
</DocsCard>
5555

5656
<DocsCard header="Components" href="/docs/components" icon="/icons/guide-components-icon.png">
57-
<p>Explore Ionics rich library of UI components for building beautiful apps.</p>
57+
<p>Explore Ionic's rich library of UI components for building beautiful apps.</p>
5858
</DocsCard>
5959

6060
</DocsCards>

docs/vue/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ import DocsCards from '@components/global/DocsCards';
1818

1919
## Vue Version Support
2020

21-
Ionic Vue supports the latest versions of Vue. For detailed information on supported versions and our support policy, see the [Ionic Vue Support Policy](/docs/reference/support#ionic-vue).
21+
Ionic Vue v8 supports Vue 3.x. For detailed information on supported versions and our support policy, see the [Ionic Vue Support Policy](/docs/reference/support#ionic-vue).
2222

2323
## Vue Tooling
2424

versioned_docs/version-v6/angular/overview.md

Lines changed: 28 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,29 +14,47 @@ sidebar_label: Overview
1414
import DocsCard from '@components/global/DocsCard';
1515
import DocsCards from '@components/global/DocsCards';
1616

17-
`@ionic/angular` combines the core Ionic experience with the tooling and APIs that are tailored to Angular Developers.
17+
`@ionic/angular` brings the full power of the Ionic Framework to Angular developers. It offers seamless integration with the Angular ecosystem, so you can build high-quality cross-platform apps using familiar Angular tools, components, and best practices. You also get access to Ionic's extensive UI library and native capabilities.
1818

1919
## Angular Version Support
2020

21-
Ionic v6 supports Angular v12-v15. As part of their upgrade strategy, Angular has built-in tooling to help automate upgrades and provide feedback to developers whenever changes to an API occurred. This reduces update friction and keeps the ecosystem in a evergreen state.
21+
Ionic Angular v6 supports Angular versions 12 through 15. For detailed information on supported versions and our support policy, see the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular).
2222

2323
## Angular Tooling
2424

25-
With Ionic 4+, the official Angular stack for building an app and routing are used, so your app can fall in-line with the rest of the great Angular ecosystem. In cases where more opinionated features are needed, Ionic provides `@ionic/angular-toolkit`, which builds and integrates with the [official Angular CLI](https://angular.io/cli) and provides features that are specific to `@ionic/angular` apps.
25+
Ionic uses the official Angular stack for building apps and routing, so your app can fall in line with the rest of the Angular ecosystem. In cases where more opinionated features are needed, Ionic provides `@ionic/angular-toolkit`, which builds and integrates with the [official Angular CLI](https://angular.io/cli) and provides features that are specific to `@ionic/angular` apps.
26+
27+
## Native Tooling
28+
29+
[Capacitor](https://capacitorjs.com) is the official cross-platform runtime for Ionic Angular, enabling your apps to run natively on iOS, Android, and the web with a single codebase.
30+
31+
## Installation
32+
33+
```shell-session
34+
$ npm install -g @ionic/cli
35+
$ ionic start myApp tabs --type angular
36+
37+
$ ionic serve █
38+
```
2639

2740
## Resources
2841

2942
<DocsCards>
30-
<DocsCard header="Getting Started" href="your-first-app" icon="/icons/feature-component-actionsheet-icon.png">
31-
<p>Learn the fundamentals you need to know to start building amazing apps with Ionic Framework.</p>
32-
</DocsCard>
3343

34-
<DocsCard header="Navigation" href="navigation" icon="/icons/feature-component-navigation-icon.png">
35-
<p>Learn the basics of navigation inside your app with Ionic and Angular Router</p>
44+
<DocsCard header="Getting Started" href="quickstart" icon="/icons/guide-quickstart-icon.png">
45+
<p>Quickly set up your first Ionic Angular app and learn the basics of the framework and CLI.</p>
46+
</DocsCard>
47+
48+
<DocsCard header="Build Your First App" href="your-first-app" icon="/icons/logo-angular-icon.png">
49+
<p>Build a real Photo Gallery app with Ionic Angular and native device features.</p>
50+
</DocsCard>
51+
52+
<DocsCard header="Navigation" href="navigation" icon="/icons/component-navigation-icon.png">
53+
<p>Master navigation in Ionic Angular using Angular Router.</p>
3654
</DocsCard>
3755

38-
<DocsCard header="Lifecycle" href="lifecycle" icon="/icons/feature-guide-components-icon.png">
39-
<p>Learn about using Ionic lifecycle events in class components and with hooks</p>
56+
<DocsCard header="Components" href="/docs/components" icon="/icons/guide-components-icon.png">
57+
<p>Explore Ionic's rich library of UI components for building beautiful apps.</p>
4058
</DocsCard>
4159

4260
</DocsCards>

versioned_docs/version-v6/vue/overview.md

Lines changed: 17 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -14,30 +14,21 @@ sidebar_label: Overview
1414
import DocsCard from '@components/global/DocsCard';
1515
import DocsCards from '@components/global/DocsCards';
1616

17-
`@ionic/vue` combines the core Ionic Framework experience with the tooling and APIs that are tailored to Vue Developers.
17+
`@ionic/vue` brings the full power of the Ionic Framework to Vue developers. It offers seamless integration with the Vue ecosystem, so you can build high-quality cross-platform apps using familiar Vue tools, components, and best practices. You also get access to Ionic's extensive UI library and native capabilities.
1818

1919
## Vue Version Support
2020

21-
Ionic Vue is built on top of Vue 3.0.0. If you've built an app with early versions of Ionic Vue, you'll want to upgrade to the latest release and upgrade your Vue dependencies.
21+
Ionic Vue v6 supports Vue 3.x. For detailed information on supported versions and our support policy, see the [Ionic Vue Support Policy](/docs/reference/support#ionic-vue).
2222

2323
## Vue Tooling
2424

25-
Ionic Vue projects ship with the same tooling as regular Vue CLI projects. Meaning you'll be building with the Vue CLI and all of it's features. In addition, starter projects also ship with few features enabled by default, like Routing and TypeScript support.
25+
Ionic Vue projects use the same tooling as standard Vue CLI projects, so you can take advantage of the full Vue CLI feature set for building, testing, and deploying your apps. Starter projects come with useful features enabled by default, such as Vue Router for navigation and TypeScript support for type safety and improved developer experience.
2626

2727
## Native Tooling
2828

29-
[Capacitor](https://capacitorjs.com) is the official cross-platform app runtime used to make your `Ionic Vue` web app run natively on iOS, Android, and the web.
29+
[Capacitor](https://capacitorjs.com) is the official cross-platform runtime for Ionic Vue, enabling your apps to run natively on iOS, Android, and the web with a single codebase.
3030

31-
While there are no known technical limitations to using `Ionic Vue` with [Cordova](https://cordova.apache.org/) plugins, Capacitor is officially recommended. There are no plans to support a Cordova integration for `Ionic Vue` in the [Ionic CLI tooling](../cli.md) at this time. For more details, please [see here](https://capacitorjs.com/docs/cordova).
32-
33-
## From the Community
34-
35-
<!-- cspell:disable -->
36-
37-
- [Using Vue.js with Ionic & Capacitor](https://dev.to/aaronksaunders/using-vue-js-v3-beta-with-ionic-components-capacitor-plugins-2b6f) - Aaron Saunders
38-
- [Building Mobile Apps With Vue3 and Ionic](https://soshace.com/building-mobile-apps-with-vue3-and-ionic/) - Oluwaseun Raphael Afolayan
39-
40-
<!-- cspell:enable -->
31+
While you can use many [Cordova](https://cordova.apache.org/) plugins with Ionic Vue, Capacitor is the recommended and fully supported solution. The [Ionic CLI](../cli.md) does not provide official Cordova integration for Ionic Vue projects. For more information on using Cordova plugins with Capacitor, see the [Capacitor documentation](https://capacitorjs.com/docs/cordova).
4132

4233
## Installation
4334

@@ -51,16 +42,21 @@ $ ionic serve █
5142
## Resources
5243

5344
<DocsCards>
54-
<DocsCard header="Getting Started" href="your-first-app" icon="/icons/feature-component-actionsheet-icon.png">
55-
<p>Learn the fundamentals you need to know to start building amazing apps with Ionic Framework.</p>
56-
</DocsCard>
5745

58-
<DocsCard header="Navigation" href="navigation" icon="/icons/feature-component-navigation-icon.png">
59-
<p>Learn the basics of navigation inside your app with Ionic and Vue Router</p>
46+
<DocsCard header="Getting Started" href="quickstart" icon="/icons/guide-quickstart-icon.png">
47+
<p>Quickly set up your first Ionic Vue app and learn the basics of the framework and CLI.</p>
48+
</DocsCard>
49+
50+
<DocsCard header="Build Your First App" href="your-first-app" icon="/icons/logo-vue-icon.png">
51+
<p>Build a real Photo Gallery app with Ionic Vue and native device features.</p>
52+
</DocsCard>
53+
54+
<DocsCard header="Navigation" href="navigation" icon="/icons/component-navigation-icon.png">
55+
<p>Master navigation in Ionic Vue using Vue Router.</p>
6056
</DocsCard>
6157

62-
<DocsCard header="Lifecycle" href="lifecycle" icon="/icons/feature-guide-components-icon.png">
63-
<p>Learn about using Ionic lifecycle events in class components and with hooks</p>
58+
<DocsCard header="Components" href="/docs/components" icon="/icons/guide-components-icon.png">
59+
<p>Explore Ionic’s rich library of UI components for building beautiful apps.</p>
6460
</DocsCard>
6561

6662
</DocsCards>

versioned_docs/version-v7/angular/overview.md

Lines changed: 26 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -14,33 +14,47 @@ sidebar_label: Overview
1414
import DocsCard from '@components/global/DocsCard';
1515
import DocsCards from '@components/global/DocsCards';
1616

17-
`@ionic/angular` combines the core Ionic experience with the tooling and APIs that are tailored to Angular Developers.
17+
`@ionic/angular` brings the full power of the Ionic Framework to Angular developers. It offers seamless integration with the Angular ecosystem, so you can build high-quality cross-platform apps using familiar Angular tools, components, and best practices. You also get access to Ionic's extensive UI library and native capabilities.
1818

1919
## Angular Version Support
2020

21-
Ionic v7 supports Angular v14+. As part of their upgrade strategy, Angular has built-in tooling to help automate upgrades and provide feedback to developers whenever changes to an API occurred. This reduces update friction and keeps the ecosystem in a evergreen state.
21+
Ionic Angular v7 supports Angular versions 14 through 17. For detailed information on supported versions and our support policy, see the [Ionic Angular Support Policy](/docs/reference/support#ionic-angular).
2222

2323
## Angular Tooling
2424

25-
With Ionic 4+, the official Angular stack for building an app and routing are used, so your app can fall in-line with the rest of the great Angular ecosystem. In cases where more opinionated features are needed, Ionic provides `@ionic/angular-toolkit`, which builds and integrates with the [official Angular CLI](https://angular.io/cli) and provides features that are specific to `@ionic/angular` apps.
25+
Ionic uses the official Angular stack for building apps and routing, so your app can fall in line with the rest of the Angular ecosystem. In cases where more opinionated features are needed, Ionic provides `@ionic/angular-toolkit`, which builds and integrates with the [official Angular CLI](https://angular.io/cli) and provides features that are specific to `@ionic/angular` apps.
26+
27+
## Native Tooling
28+
29+
[Capacitor](https://capacitorjs.com) is the official cross-platform runtime for Ionic Angular, enabling your apps to run natively on iOS, Android, and the web with a single codebase.
30+
31+
## Installation
32+
33+
```shell-session
34+
$ npm install -g @ionic/cli
35+
$ ionic start myApp tabs --type angular
36+
37+
$ ionic serve █
38+
```
2639

2740
## Resources
2841

2942
<DocsCards>
30-
<DocsCard header="Getting Started" href="your-first-app" icon="/icons/feature-component-actionsheet-icon.png">
31-
<p>Learn the fundamentals you need to know to start building amazing apps with Ionic Framework.</p>
32-
</DocsCard>
3343

34-
<DocsCard header="Navigation" href="navigation" icon="/icons/feature-component-navigation-icon.png">
35-
<p>Learn the basics of navigation inside your app with Ionic and Angular Router</p>
44+
<DocsCard header="Getting Started" href="quickstart" icon="/icons/guide-quickstart-icon.png">
45+
<p>Quickly set up your first Ionic Angular app and learn the basics of the framework and CLI.</p>
46+
</DocsCard>
47+
48+
<DocsCard header="Build Your First App" href="your-first-app" icon="/icons/logo-angular-icon.png">
49+
<p>Build a real Photo Gallery app with Ionic Angular and native device features.</p>
3650
</DocsCard>
3751

38-
<DocsCard header="Lifecycle" href="lifecycle" icon="/icons/feature-guide-components-icon.png">
39-
<p>Learn about using Ionic lifecycle events in class components and with hooks</p>
52+
<DocsCard header="Navigation" href="navigation" icon="/icons/component-navigation-icon.png">
53+
<p>Master navigation in Ionic Angular using Angular Router.</p>
4054
</DocsCard>
4155

42-
<DocsCard header="Build Options" href="build-options" icon="/icons/logo-angular-icon.png">
43-
<p>Learn about using Modules or Standalone Components in Ionic.</p>
56+
<DocsCard header="Components" href="/docs/components" icon="/icons/guide-components-icon.png">
57+
<p>Explore Ionic's rich library of UI components for building beautiful apps.</p>
4458
</DocsCard>
4559

4660
</DocsCards>

versioned_docs/version-v7/vue/overview.md

Lines changed: 17 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -14,30 +14,21 @@ sidebar_label: Overview
1414
import DocsCard from '@components/global/DocsCard';
1515
import DocsCards from '@components/global/DocsCards';
1616

17-
`@ionic/vue` combines the core Ionic Framework experience with the tooling and APIs that are tailored to Vue Developers.
17+
`@ionic/vue` brings the full power of the Ionic Framework to Vue developers. It offers seamless integration with the Vue ecosystem, so you can build high-quality cross-platform apps using familiar Vue tools, components, and best practices. You also get access to Ionic's extensive UI library and native capabilities.
1818

1919
## Vue Version Support
2020

21-
Ionic Vue is built on top of Vue 3.0.0. If you've built an app with early versions of Ionic Vue, you'll want to upgrade to the latest release and upgrade your Vue dependencies.
21+
Ionic Vue v7 supports Vue 3.x. For detailed information on supported versions and our support policy, see the [Ionic Vue Support Policy](/docs/reference/support#ionic-vue).
2222

2323
## Vue Tooling
2424

25-
Ionic Vue projects ship with the same tooling as regular Vue CLI projects. Meaning you'll be building with the Vue CLI and all of it's features. In addition, starter projects also ship with few features enabled by default, like Routing and TypeScript support.
25+
Ionic Vue projects use the same tooling as standard Vue CLI projects, so you can take advantage of the full Vue CLI feature set for building, testing, and deploying your apps. Starter projects come with useful features enabled by default, such as Vue Router for navigation and TypeScript support for type safety and improved developer experience.
2626

2727
## Native Tooling
2828

29-
[Capacitor](https://capacitorjs.com) is the official cross-platform app runtime used to make your `Ionic Vue` web app run natively on iOS, Android, and the web.
29+
[Capacitor](https://capacitorjs.com) is the official cross-platform runtime for Ionic Vue, enabling your apps to run natively on iOS, Android, and the web with a single codebase.
3030

31-
While there are no known technical limitations to using `Ionic Vue` with [Cordova](https://cordova.apache.org/) plugins, Capacitor is officially recommended. There are no plans to support a Cordova integration for `Ionic Vue` in the [Ionic CLI tooling](../cli.md) at this time. For more details, please [see here](https://capacitorjs.com/docs/cordova).
32-
33-
## From the Community
34-
35-
<!-- cspell:disable -->
36-
37-
- [Using Vue.js with Ionic & Capacitor](https://dev.to/aaronksaunders/using-vue-js-v3-beta-with-ionic-components-capacitor-plugins-2b6f) - Aaron Saunders
38-
- [Building Mobile Apps With Vue3 and Ionic](https://soshace.com/building-mobile-apps-with-vue3-and-ionic/) - Oluwaseun Raphael Afolayan
39-
40-
<!-- cspell:enable -->
31+
While you can use many [Cordova](https://cordova.apache.org/) plugins with Ionic Vue, Capacitor is the recommended and fully supported solution. The [Ionic CLI](../cli.md) does not provide official Cordova integration for Ionic Vue projects. For more information on using Cordova plugins with Capacitor, see the [Capacitor documentation](https://capacitorjs.com/docs/cordova).
4132

4233
## Installation
4334

@@ -51,16 +42,21 @@ $ ionic serve █
5142
## Resources
5243

5344
<DocsCards>
54-
<DocsCard header="Getting Started" href="your-first-app" icon="/icons/feature-component-actionsheet-icon.png">
55-
<p>Learn the fundamentals you need to know to start building amazing apps with Ionic Framework.</p>
56-
</DocsCard>
5745

58-
<DocsCard header="Navigation" href="navigation" icon="/icons/feature-component-navigation-icon.png">
59-
<p>Learn the basics of navigation inside your app with Ionic and Vue Router</p>
46+
<DocsCard header="Getting Started" href="quickstart" icon="/icons/guide-quickstart-icon.png">
47+
<p>Quickly set up your first Ionic Vue app and learn the basics of the framework and CLI.</p>
48+
</DocsCard>
49+
50+
<DocsCard header="Build Your First App" href="your-first-app" icon="/icons/logo-vue-icon.png">
51+
<p>Build a real Photo Gallery app with Ionic Vue and native device features.</p>
52+
</DocsCard>
53+
54+
<DocsCard header="Navigation" href="navigation" icon="/icons/component-navigation-icon.png">
55+
<p>Master navigation in Ionic Vue using Vue Router.</p>
6056
</DocsCard>
6157

62-
<DocsCard header="Lifecycle" href="lifecycle" icon="/icons/feature-guide-components-icon.png">
63-
<p>Learn about using Ionic lifecycle events in class components and with hooks</p>
58+
<DocsCard header="Components" href="/docs/components" icon="/icons/guide-components-icon.png">
59+
<p>Explore Ionic’s rich library of UI components for building beautiful apps.</p>
6460
</DocsCard>
6561

6662
</DocsCards>

0 commit comments

Comments
 (0)