diff --git a/docs/angular/lifecycle.md b/docs/angular/lifecycle.md index 0f981e64dc3..21d40f06104 100644 --- a/docs/angular/lifecycle.md +++ b/docs/angular/lifecycle.md @@ -13,7 +13,7 @@ sidebar_label: Lifecycle This guide covers how the page life cycle works in an app built with Ionic and Angular. -![Ionic life cycle events demo](/img/guides/lifecycle/ioniclifecycle.png) +![Flowchart illustrating the Ionic page life cycle events and their sequence.](/img/guides/lifecycle/ioniclifecycle.png 'Ionic Lifecycle Diagram') ## Angular Life Cycle Events @@ -47,7 +47,7 @@ The difference between `ionViewWillEnter` and `ionViewDidEnter` is when they fir For `ionViewWillLeave` and `ionViewDidLeave`, `ionViewWillLeave` gets called directly before the transition away from the current page begins, and `ionViewDidLeave` does not get called until after the new page gets successfully transitioned into (after the new pages `ionViewDidEnter` fires). -![Ionic life cycle events demo](/img/guides/lifecycle/ioniclifecycle.gif) +![Animated GIF showing Ionic page life cycle events in a console log as a page transition occurs.](/img/guides/lifecycle/ioniclifecycle.gif 'Ionic Lifecycle Animation') ## How Ionic Handles the Life of a Page diff --git a/docs/angular/your-first-app.md b/docs/angular/your-first-app.md index b876e2f66c4..739a9c3d29b 100644 --- a/docs/angular/your-first-app.md +++ b/docs/angular/your-first-app.md @@ -132,7 +132,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to transform into a Photo Gallery. The Ionic CLI features Live Reload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-cap-ng/email-photogallery.gif) +![Animated GIF showing the live reload feature in an Ionic app, with changes in code immediately updating the app in a web browser.](/img/guides/first-app-cap-ng/email-photogallery.gif 'Live Reload Feature in Ionic App') Open the photo-gallery app folder in your code editor of choice, then navigate to `/src/app/tab2/tab2.page.html`. We see: diff --git a/docs/angular/your-first-app/2-taking-photos.md b/docs/angular/your-first-app/2-taking-photos.md index 2c94527390e..0e0cd078a70 100644 --- a/docs/angular/your-first-app/2-taking-photos.md +++ b/docs/angular/your-first-app/2-taking-photos.md @@ -70,7 +70,7 @@ Then, open `tab2.page.html` and call the `addPhotoToGallery()` function when the Save the file, and if it's not running already, restart the development server in your browser by running `ionic serve`. On the Photo Gallery tab, click the Camera button. If your computer has a webcam of any sort, a modal window appears. Take a selfie! -![Camera API on the web](/img/guides/first-app-cap-ng/camera-web.png) +![A photo gallery app displaying a webcam selfie.](/img/guides/first-app-cap-ng/camera-web.png 'Webcam Selfie in Photo Gallery') _(Your selfie is probably much better than mine)_ diff --git a/docs/angular/your-first-app/6-deploying-mobile.md b/docs/angular/your-first-app/6-deploying-mobile.md index e30d8acd79d..e9637084b7b 100644 --- a/docs/angular/your-first-app/6-deploying-mobile.md +++ b/docs/angular/your-first-app/6-deploying-mobile.md @@ -60,7 +60,7 @@ ionic cap open ios In order for some native plugins to work, user permissions must be configured. In our photo gallery app, this includes the Camera plugin: iOS displays a modal dialog automatically after the first time that `Camera.getPhoto()` is called, prompting the user to allow the app to use the Camera. The permission that drives this is labeled “Privacy - Camera Usage.” To set it, the `Info.plist` file must be modified ([more details here](https://capacitorjs.com/docs/ios/configuration)). To access it, click "Info," then expand "Custom iOS Target Properties." -![Xcode Custom iOS Target Properties](/img/guides/first-app-cap-ng/xcode-info-plist.png) +![The Info.plist file in Xcode showing the NSCameraUsageDescription key added for camera access.](/img/guides/first-app-cap-ng/xcode-info-plist.png 'Xcode Info.plist Configuration') Each setting in `Info.plist` has a low-level parameter name and a high-level name. By default, the property list editor shows the high-level names, but it's often useful to switch to showing the raw, low-level names. To do this, right-click anywhere in the property list editor and toggle "Raw Keys/Values." @@ -70,15 +70,15 @@ Follow the same process to add the other two Keys required of the Camera plugin: Next, click on `App` in the Project Navigator on the left-hand side, then within the `Signing & Capabilities` section, select your Development Team. -![Xcode - Selecting Development Team](/img/guides/first-app-cap-ng/xcode-signing.png) +![The Xcode interface displaying the Signing and Capabilities tab for an iOS app project.](/img/guides/first-app-cap-ng/xcode-signing.png 'Xcode Signing & Capabilities') With permissions in place and Development Team selected, we are ready to try out the app on a real device! Connect an iOS device to your Mac computer, select it (`App -> Matthew’s iPhone` for me) then click the "Build" button to build, install, and launch the app on your device: -![Xcode build button](/img/guides/first-app-cap-ng/xcode-build-button.png) +![Xcode toolbar highlighting the Build button used to compile and run an iOS app.](/img/guides/first-app-cap-ng/xcode-build-button.png 'Xcode Build Button') Upon tapping the Camera button on the Photo Gallery tab, the permission prompt will display. Tap OK, then take a picture with the Camera. Afterward, the photo shows in the app! -![iOS Camera permissions](/img/guides/first-app-cap-ng/ios-permissions-photo.png) +![Two iPhones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/ios-permissions-photo.png 'iOS Camera Permission Prompt and Photo Result') ## Android Deployment @@ -92,7 +92,7 @@ ionic cap open android Similar to iOS, we must enable the correct permissions to use the Camera. Configure these in the `AndroidManifest.xml` file. Android Studio will likely open this file automatically, but in case it doesn't, locate it under `android/app/src/main/`. -![Android Manifest location](/img/guides/first-app-cap-ng/android-manifest.png) +![Android Studio editor showing the AndroidManifest.xml file with camera permissions.](/img/guides/first-app-cap-ng/android-manifest.png 'Android Manifest Permissions') Scroll to the `Permissions` section and ensure these entries are included: @@ -103,11 +103,11 @@ Scroll to the `Permissions` section and ensure these entries are included: Save the file. With permissions in place, we are ready to try out the app on a real device! Connect an Android device to your computer. Within Android Studio, click the "Run" button, select the attached Android device, then click OK to build, install, and launch the app on your device. -![Launching app on Android](/img/guides/first-app-cap-ng/android-device.png) +![The Android Studio interface with arrows pointing to the Run button and the connected device.](/img/guides/first-app-cap-ng/android-device.png 'Android Studio Run Configuration') Once again, upon tapping the Camera button on the Photo Gallery tab, the permission prompt should be displayed. Tap OK, then take a picture with the Camera. Afterward, the photo should appear in the app. -![Android Camera permissions](/img/guides/first-app-cap-ng/android-permissions-photo.png) +![Two Android phones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/android-permissions-photo.png 'Android Permissions and Photo Capture') Our Photo Gallery app has just been deployed to Android and iOS devices. 🎉 diff --git a/docs/core-concepts/webview.md b/docs/core-concepts/webview.md index a314d09f566..359ead6fae3 100644 --- a/docs/core-concepts/webview.md +++ b/docs/core-concepts/webview.md @@ -22,7 +22,7 @@ Ionic apps are built using [web technologies](../reference/glossary.md#web-stand Modern Web Views offer many built-in HTML5 APIs for hardware functionality such as cameras, sensors, GPS, speakers, and Bluetooth, but sometimes it may also be necessary to access platform-specific hardware APIs. In Ionic apps, hardware APIs can be accessed through a bridge layer, typically by using native plugins which expose JavaScript APIs. -![webview architecture](/img/building/webview-architecture.png) +![Diagram illustrating the architecture of a Web View in Ionic apps, showing the bridge between native app components and web components.](/img/building/webview-architecture.png 'Web View Architecture Diagram') The Ionic Web View plugin is specialized for modern JavaScript apps. For both iOS and Android, app files are always hosted using the `http://` protocol with an optimized HTTP server that runs on the local device. diff --git a/docs/deployment/play-store.mdx b/docs/deployment/play-store.mdx index f871fe34963..ce2dd35317e 100644 --- a/docs/deployment/play-store.mdx +++ b/docs/deployment/play-store.mdx @@ -69,15 +69,15 @@ If you haven't made the switch to Android app bundles yet, you will need to opt First, create a new app in the Google Play Console. In order to enable app signing, you'll need to navigate to the new release screen, on one of the Production, Open testing, closed testing, or internal testing pages. Select the Create new release button as seen below (it doesn't matter which release type, since you don't have to actually go through with creating a new release right now): -![Select create new release in Google Play Console's Production tab](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-release-1024x561.png) +![Google Play Console's Production tab with arrow pointing to the 'Create new release' button.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-release-1024x561.png "Google Play Console New Release Creation") Under the App integrity section, click the **Change app signing key** button: -![Select change app signing key in Google Play Console's Production tab](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-signingkey.png) +![Google Play Console's App integrity section with the 'Change app signing key' button highlighted.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-signingkey.png "Google Play Console Change App Signing Key Option") Next, select the **Export and upload a key from Java Keystore** option. This is the only way in which you can retain the key and have Google Play use it for signing. If you're using Appflow to build Android apps in the cloud, this is also the required option so you can upload the keystore file to Appflow. -![Uploading a keystore file to Google Play Console](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-export-1024x564.png) +![The Google Play Console showing the option to 'Export and upload a key from Java Keystore'.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-export-1024x564.png "Google Play Console Export and Upload Key Option") Follow the instructions on the screen to generate the Keystore and you can use the same Keystore file to sign your app in the Appflow dashboard as well. If you need any help generating the Keystore file, you can refer to our docs [here](https://ionic.io/docs/appflow/package/credentials#android-certificates). Once the generated zip file has been uploaded, you're all set! Build an AAB binary signed with the keystore file then upload it to Google Play. @@ -88,7 +88,7 @@ As of now, existing apps aren't required to use the AAB format, but you can stil To opt into app signing, you'll need to upload the app signing key used to sign previous releases of the app. Navigate to Setup -> App integrity, then choose one of the two methods seen in the screenshot below. Once the key has been uploaded, you can enroll in Play App Signing. -![App integrity setup in Google Play Console](https://blog.ionicframework.com/wp-content/uploads/2021/12/existingapps-optin.png) +![The opt-in options for Play App Signing in the Google Play Console.](https://blog.ionicframework.com/wp-content/uploads/2021/12/existingapps-optin.png "Google Play Console Opt-in to Play App Signing") :::tip With smaller app sizes, improved performance, and enhanced security, the AAB binary format is a win for app developers and users alike. If you have an existing Android app using the APK format, consider migrating to AAB to take advantage of all the great features it provides. @@ -140,7 +140,7 @@ Making a developer account with Google Play costs $25 USD. Once a developer account has been created, go ahead and click the `Create an Application` -![Create an App button](/img/publishing/newAppGPlay.png) +![The Google Play Store Developer Console with the 'CREATE APPLICATION' button highlighted.](/img/publishing/newAppGPlay.png "Google Play Store Create Application Button") Be sure to fill out the description for the app along with providing screenshots and additional info. When ready, upload the signed release AAB/APK that was generated and publish the app. diff --git a/docs/developer-resources/guides/first-app-v3/intro.md b/docs/developer-resources/guides/first-app-v3/intro.md index 844aef86a7e..4d44434249f 100644 --- a/docs/developer-resources/guides/first-app-v3/intro.md +++ b/docs/developer-resources/guides/first-app-v3/intro.md @@ -2,7 +2,7 @@ The great thing about Ionic is that with one codebase, you can build for any platform using familiar web tools and languages. Follow along as we create a working Photo Gallery. Here’s the before and after: -![Before and after going through this tutorial](/img/guides/first-app-v3/gallery-combined.png) +![An Ionic app's transformation from a blank 'Tab Two' to a 'Photo Gallery' with images.](/img/guides/first-app-v3/gallery-combined.png 'Ionic App Before and After Photo Gallery') It’s easy to get started. Reference code for this guide can be [found on GitHub](https://github.com/ionic-team/photo-gallery-tutorial-ionic3/). @@ -76,7 +76,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs: “Home”, “About”, and “Contact.” Click on the About tab. It’s a blank canvas, aka the perfect spot to add camera functionality. Let’s begin to transform the About page into a Photo Gallery. Ionic features LiveReload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-v3/email-photogallery.gif) +![Animated GIF demonstrating the LiveReload feature in Ionic, showing real-time updates in the app after code changes.](/img/guides/first-app-v3/email-photogallery.gif 'Ionic LiveReload Feature Demonstration') Open the photo-gallery app folder in your favorite code editor of choice, then navigate to `/src/pages/about/about.html`. We see: diff --git a/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md b/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md index da6f9462ecc..61d4605e865 100644 --- a/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md +++ b/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md @@ -17,7 +17,7 @@ $ ionic cordova plugin add cordova-plugin-ionic@latest --save There are two unique values to provide: your app id and channel name. Sign into Appflow, then find the App Id on your app’s dashboard: -![app id location](/img/guides/first-app-v3/app-id-location.png) +![The location of the App ID in the Appflow dashboard.](/img/guides/first-app-v3/app-id-location.png 'Appflow App ID Location') And we’ll just use “Master” as the channel name. Putting this together looks like: @@ -168,7 +168,7 @@ $ git push ionic master Log into the [Appflow dashboard](https://dashboard.ionicframework.com) and navigate to Deploy -> Builds. You’ll see this newest commit begin to build immediately. Since we assigned the Appflow plugin to the Master branch (the one we always Git Push to), the Channel label will also point to this commit, effectively auto-deploying this change to all app users: -![deploy channel](/img/guides/first-app-v3/deploy-channel.png) +![The Deploy Builds section in the Appflow dashboard.](/img/guides/first-app-v3/deploy-channel.png 'Appflow Deploy Builds') A Channel points to a specific JavaScript Build or Snapshot of your app that will be shared with devices listening to that channel for updates. You can change which Build a Channel points to whenever you’d like. @@ -180,7 +180,7 @@ What if you deploy a change, then realize that there is a bug? Or perhaps you’ On the Deploy Builds page, click the “Assign to Channel” button on the previous commit, then click “Deploy.” App users will be reverted to the previous version, and our “Photo Gallery” name has been restored. -![deploy channel](/img/guides/first-app-v3/deploy-revertChange.png) +![The Deploy Builds section in Appflow with a commit labeled 'set name to Photo Gallery' being assigned to the master channel for rollback.](/img/guides/first-app-v3/deploy-revertChange.png 'Appflow Deploy Revert Change') This was just a taste of what you can do with Appflow Live Updates! You can also set up multiple deployment channels to send targeted updates to specific groups of users. Use it to run A/B tests, or target the distribution of updates by audience, geography, or test group. diff --git a/docs/developer-resources/guides/first-app-v3/theming.md b/docs/developer-resources/guides/first-app-v3/theming.md index 19ef3364069..077186843fc 100644 --- a/docs/developer-resources/guides/first-app-v3/theming.md +++ b/docs/developer-resources/guides/first-app-v3/theming.md @@ -4,11 +4,11 @@ Previously, we converted our single use Camera app into an epic photo gallery. N Ionic has five default colors, defined as Sass variables, that can be used to change the color of its UI components: -![v3-theming](/img/guides/first-app-v3/v3-theming.png) +![Ionic's default Sass color variables for theming: 'primary", secondary, danger, light, and dark.](/img/guides/first-app-v3/v3-theming.png 'Default Ionic Sass Variables') You can customize each color further by supplying a base and contract property. Base acts as the background color and contrast acts as the text color for most components. This provides much more flexible control over your styles: -![v3-theming-colors](/img/guides/first-app-v3/v3-themeColors.png) +![Code snippet showing customized Ionic Sass variables with additional twitter color base and contrast properties.](/img/guides/first-app-v3/v3-themeColors.png 'Customized Ionic Sass Variables') You can find these colors defined in `src/theme/variables.scss`. @@ -22,7 +22,7 @@ $colors: ( But wait, there’s more! Ionic automatically provides platform specific styles based on the device the application is running on, giving that native look and feel your users are used to: -![ios and android comparison](/img/guides/first-app-v3/ion-lab-comparison.png) +![Comparing the native look of an Ionic app on iOS and Android platforms.](/img/guides/first-app-v3/ion-lab-comparison.png 'Ionic Platform Specific Styles Comparison') In our app, this is clearly visible in how the header and the icons are styled. @@ -40,7 +40,7 @@ imports: [ Now, the iOS version of our app has a Material Design skin! -![ios and android comparison](/img/guides/first-app-v3/ion-lab-md-styling.png) +![An Ionic app with Material Design styling applied on an iOS device.](/img/guides/first-app-v3/ion-lab-md-styling.png 'Ionic Material Design Styling on iOS') Creating gorgeous-looking Ionic apps is easy with Sass variables and platform-specific styling. You now have everything you need to get started with Ionic. Go forth and build great apps! diff --git a/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md b/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md index c4fac8c2871..0417b953de6 100644 --- a/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md +++ b/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md @@ -75,11 +75,11 @@ ionic serve Tap on the Gallery tab, then the camera button. A runtime error should occur. In a browser, head over to the [Appflow dashboard](https://dashboard.ionicframework.com), then Monitor -> Monitoring. After a few minutes, the error should appear: -![event monitoring](/img/guides/first-app-v3/monitoring-event.png) +![An event showing error 'takePhoto is not a function' with status 'New'.](/img/guides/first-app-v3/monitoring-event.png 'Ionic Monitoring Event Overview') Clicking on the event gives us lots of details surrounding what happened, such as a full stack trace. In this instance, we see that the error occurred three times on Mac OS X in the Chrome web browser. -![event details](/img/guides/first-app-v3/monitoring-details.png) +![Detailed view of an event log displaying a TypeError stack trace and error details such as device, browser, and operating system.](/img/guides/first-app-v3/monitoring-details.png 'Detailed Ionic Monitoring Event Log') Given the proliferation of mobile devices and operating systems these days, this is immensely powerful. Armed with these details, we can hone in on the problem and fix it quickly. diff --git a/docs/developer-resources/guides/first-app-v4/intro.md b/docs/developer-resources/guides/first-app-v4/intro.md index bffc7ea9c28..153afc5646f 100644 --- a/docs/developer-resources/guides/first-app-v4/intro.md +++ b/docs/developer-resources/guides/first-app-v4/intro.md @@ -2,7 +2,7 @@ The great thing about Ionic is that with one codebase, you can build for any platform using familiar web tools and languages. Follow along as we create a working Photo Gallery. Here’s the before and after: -![Before and after going through this tutorial](/img/guides/first-app-v3/gallery-combined.png) +![An Ionic app's transformation from a blank 'Tab Two' to a 'Photo Gallery' with images.](/img/guides/first-app-v3/gallery-combined.png 'Ionic App Before and After Photo Gallery') It’s easy to get started. Note that all code referenced in this guide can be [found on GitHub](https://github.com/ionic-team/photo-gallery-tutorial-ionic4/). @@ -65,7 +65,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to add camera functionality. Let’s begin to transform this page into a Photo Gallery. Ionic features LiveReload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-v3/email-photogallery.gif) +![Animated GIF demonstrating the LiveReload feature in Ionic, showing real-time updates in the app after code changes.](/img/guides/first-app-v3/email-photogallery.gif 'Ionic LiveReload Feature Demonstration') Open the photo-gallery app folder in your favorite code editor of choice, then navigate to `/src/app/tab2/tab2.page.html`. We see: diff --git a/docs/developer-resources/guides/first-app-v4/theming.md b/docs/developer-resources/guides/first-app-v4/theming.md index 6170b2d673a..c185f6761c1 100644 --- a/docs/developer-resources/guides/first-app-v4/theming.md +++ b/docs/developer-resources/guides/first-app-v4/theming.md @@ -4,11 +4,11 @@ Previously, we converted our single use Camera app into an epic photo gallery. N Ionic has nine default colors, defined as CSS variables, that can be used to change the color of its UI components: -![v4-theming-defaults](/img/guides/first-app-v4/theming-defaults.png) +![A chart showing Ionic's nine default colors with their hex codes.](/img/guides/first-app-v4/theming-defaults.png 'Ionic Default Color Palette') You can customize each color further by supplying a base, contrast, shade, and tint properties. These provide flexible control over your styles: -![v4-theming-properties](/img/guides/first-app-v4/theming-properties.png) +![Table detailing the properties for customizing the primary color in Ionic, including base, contrast, shade, and tint.](/img/guides/first-app-v4/theming-properties.png 'Ionic Color Customization Properties') You can find these colors defined in `src/theme/variables.scss`. @@ -31,7 +31,7 @@ The easiest and most powerful way to create custom color palettes for your app But wait, there’s more! Ionic automatically provides platform specific styles based on the device the application is running on, giving that native look and feel your users are used to: -![ios and android comparison](/img/guides/first-app-v3/ion-lab-comparison.png) +![Comparing the native look of an Ionic app on iOS and Android platforms.](/img/guides/first-app-v3/ion-lab-comparison.png 'Ionic Platform Specific Styles Comparison') In our app, this is clearly visible in how the header and the icons are styled. @@ -49,7 +49,7 @@ imports: [ Now, the iOS version of our app has a Material Design skin! -![ios and android comparison](/img/guides/first-app-v3/ion-lab-md-styling.png) +![An Ionic app with Material Design styling applied on an iOS device.](/img/guides/first-app-v3/ion-lab-md-styling.png 'Ionic Material Design Styling on iOS') Creating gorgeous-looking Ionic apps is easy with CSS variables and platform-specific styling. You now have everything you need to get started with Ionic. diff --git a/docs/developing/tips.md b/docs/developing/tips.md index 2adf19ea58d..965665f9f00 100644 --- a/docs/developing/tips.md +++ b/docs/developing/tips.md @@ -122,7 +122,7 @@ By default, when an app is viewed in the browser, Ionic will apply the `md` mode This will not change which platform the browser sees being used. The platform is determined by device detection and inspecting the user-agent. To change the platform, the user-agent must be changed. To do this, open up Chrome DevTools with Ctrl+Shift+I(Cmd+Option+I on Mac), and then toggle device mode on with Ctrl+Shift+M(Cmd+Option+M on Mac). ::: -![app with a different mode](/img/faq/tips/change-device-platform.png) +![Chrome DevTools showing the device mode with iPhone X selected.](/img/faq/tips/change-device-platform.png 'Chrome DevTools Device Mode') Selecting devices from the device dropdown will change the user-agent, as well as the dimensions of the viewport. diff --git a/docs/intro/cli.md b/docs/intro/cli.md index 0ddf23169d3..38a8a37e4b8 100644 --- a/docs/intro/cli.md +++ b/docs/intro/cli.md @@ -48,7 +48,7 @@ Create an Ionic app using one of the pre-made app templates, or a blank one to s ionic start ``` -![start app thumbnails](/img/installation/start-app-thumbnails.png) +![Three thumbnail previews of Ionic app templates: blank, tabs, and side menu.](/img/installation/start-app-thumbnails.png 'Ionic App Starter Templates') To learn more about starting Ionic apps, see the [Starting Guide](../developing/starting.md). diff --git a/docs/react/quickstart.md b/docs/react/quickstart.md index f7bef34201b..1d702a65433 100644 --- a/docs/react/quickstart.md +++ b/docs/react/quickstart.md @@ -127,7 +127,7 @@ Now the `App` does not really have a lot to modify here. It's a basic example of Currently, the `Home` component looks like so: -![React home component](/img/guides/react/first-app/home-route.png) +![The Home component displayed in a web browser with the text 'The world is your oyster'.](/img/guides/react/first-app/home-route.png 'Ionic React Home Component') ```tsx import { IonContent, IonHeader, IonPage, IonTitle, IonToolbar } from '@ionic/react'; diff --git a/docs/react/your-first-app.md b/docs/react/your-first-app.md index d4428b1a5e2..b1fe24b6ec5 100644 --- a/docs/react/your-first-app.md +++ b/docs/react/your-first-app.md @@ -124,7 +124,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to transform into a Photo Gallery. The Ionic CLI features Live Reload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/react/first-app/live-reload.gif) +![Animated GIF showing the live reload feature in an Ionic app, with changes in code immediately updating the app in a web browser.](/img/guides/react/first-app/live-reload.gif 'Live Reload Feature in Ionic App') Open `/src/pages/Tab2.tsx`. We see: diff --git a/docs/react/your-first-app/2-taking-photos.md b/docs/react/your-first-app/2-taking-photos.md index ac70c03c26c..23f63ef6166 100644 --- a/docs/react/your-first-app/2-taking-photos.md +++ b/docs/react/your-first-app/2-taking-photos.md @@ -72,7 +72,7 @@ const Tab2: React.FC = () => { Save the file, and if you’re not already, restart the development server in your browser by running `ionic serve`. On the Photo Gallery tab, click the Camera button. If your computer has a webcam of any sort, a modal window appears. Take a selfie! -![Camera API on the web](/img/guides/first-app-cap-ng/camera-web.png) +![A photo gallery app displaying a webcam selfie.](/img/guides/first-app-cap-ng/camera-web.png 'Webcam Selfie in Photo Gallery') _(Your selfie is probably much better than mine)_ diff --git a/docs/react/your-first-app/6-deploying-mobile.md b/docs/react/your-first-app/6-deploying-mobile.md index 70b47820eb6..da780fa76ab 100644 --- a/docs/react/your-first-app/6-deploying-mobile.md +++ b/docs/react/your-first-app/6-deploying-mobile.md @@ -53,7 +53,7 @@ ionic cap open ios In order for some native plugins to work, user permissions must be configured. In our photo gallery app, this includes the Camera plugin: iOS displays a modal dialog automatically after the first time that `Camera.getPhoto()` is called, prompting the user to allow the app to use the Camera. The permission that drives this is labeled “Privacy - Camera Usage.” To set it, the `Info.plist` file must be modified ([more details here](https://capacitorjs.com/docs/ios/configuration)). To access it, click "Info," then expand "Custom iOS Target Properties." -![Xcode Custom iOS Target Properties](/img/guides/first-app-cap-ng/xcode-info-plist.png) +![The Info.plist file in Xcode showing the NSCameraUsageDescription key added for camera access.](/img/guides/first-app-cap-ng/xcode-info-plist.png 'Xcode Info.plist Configuration') Each setting in `Info.plist` has a low-level parameter name and a high-level name. By default, the property list editor shows the high-level names, but it's often useful to switch to showing the raw, low-level names. To do this, right-click anywhere in the property list editor and toggle "Raw Keys/Values." @@ -63,15 +63,15 @@ Follow the same process to add the other two Keys required of the Camera plugin: Next, click on `App` in the Project Navigator on the left-hand side, then within the `Signing & Capabilities` section, select your Development Team. -![Xcode - Selecting Development Team](/img/guides/first-app-cap-ng/xcode-signing.png) +![The Xcode interface displaying the Signing and Capabilities tab for an iOS app project.](/img/guides/first-app-cap-ng/xcode-signing.png 'Xcode Signing & Capabilities') With permissions in place and Development Team selected, we are ready to try out the app on a real device! Connect an iOS device to your Mac computer, select it (`App -> Matthew’s iPhone` for me) then click the "Build" button to build, install, and launch the app on your device: -![Xcode build button](/img/guides/first-app-cap-ng/xcode-build-button.png) +![Xcode toolbar highlighting the Build button used to compile and run an iOS app.](/img/guides/first-app-cap-ng/xcode-build-button.png 'Xcode Build Button') Upon tapping the Camera button on the Photo Gallery tab, the permission prompt will display. Tap OK, then take a picture with the Camera. Afterward, the photo shows in the app! -![iOS Camera permissions](/img/guides/first-app-cap-ng/ios-permissions-photo.png) +![Two iPhones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/ios-permissions-photo.png 'iOS Camera Permission Prompt and Photo Result') ## Android @@ -85,7 +85,7 @@ ionic cap open android Similar to iOS, we must enable the correct permissions to use the Camera. Configure these in the `AndroidManifest.xml` file. Android Studio will likely open this file automatically, but in case it doesn't, locate it under `android/app/src/main/`. -![Android Manifest location](/img/guides/first-app-cap-ng/android-manifest.png) +![Android Studio editor showing the AndroidManifest.xml file with camera permissions.](/img/guides/first-app-cap-ng/android-manifest.png 'Android Manifest Permissions') Scroll to the `Permissions` section and ensure these entries are included: @@ -96,11 +96,11 @@ Scroll to the `Permissions` section and ensure these entries are included: Save the file. With permissions in place, we are ready to try out the app on a real device! Connect an Android device to your computer. Within Android Studio, click the "Run" button, select the attached Android device, then click OK to build, install, and launch the app on your device. -![Launching app on Android](/img/guides/first-app-cap-ng/android-device.png) +![The Android Studio interface with arrows pointing to the Run button and the connected device.](/img/guides/first-app-cap-ng/android-device.png 'Android Studio Run Configuration') Once again, upon tapping the Camera button on the Photo Gallery tab, the permission prompt should be displayed. Tap OK, then take a picture with the Camera. Afterward, the photo should appear in the app. -![Android Camera permissions](/img/guides/first-app-cap-ng/android-permissions-photo.png) +![Two Android phones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/android-permissions-photo.png 'Android Permissions and Photo Capture') Our Photo Gallery app has just been deployed to Android and iOS devices. 🎉 diff --git a/docs/theming/advanced.md b/docs/theming/advanced.md index 8f3b75379c9..2e91f82bccf 100644 --- a/docs/theming/advanced.md +++ b/docs/theming/advanced.md @@ -32,9 +32,9 @@ The example below demonstrates how to use `theme-color` to style the browser int ``` -| Light Mode | Dark Mode | -| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| ![Application with theme-color meta in light mode](/img/theming/theme-color-light.png) | ![Application with theme-color meta in dark mode](/img/theming/theme-color-dark.png) | +| Light Mode | Dark Mode | +| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | +| ![The light mode theme color in a browser interface.](/img/theming/theme-color-light.png 'Light Mode Theme Color') | ![The dark mode theme color in a browser interface.](/img/theming/theme-color-dark.png 'Dark Mode Theme Color') | The `theme-color` meta can also be used to customize the toolbar in Safari on macOS Monterey or newer. diff --git a/docs/theming/dark-mode.md b/docs/theming/dark-mode.md index 9d87c0bd484..3dfd6451334 100644 --- a/docs/theming/dark-mode.md +++ b/docs/theming/dark-mode.md @@ -190,9 +190,9 @@ This allows the page to indicate which color scheme it is comfortable being rend color-scheme: light dark; ``` -| Default scrollbar | Scrollbar with `color-scheme` | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------- | -| ![Application without color-scheme](/img/theming/color-scheme-light.png) | ![Application with color-scheme](/img/theming/color-scheme-dark.png) | +| Default scrollbar | Scrollbar with `color-scheme` | +| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ![A default light-themed scrollbar in an application interface.](/img/theming/color-scheme-light.png 'Default scrollbar appearance without dark mode') | ![A dark-themed scrollbar in an application interface, demonstrating the effect of the 'color-scheme' property.](/img/theming/color-scheme-dark.png "Scrollbar appearance with dark mode 'color-scheme' applied") | For more information regarding `color-scheme` please see https://web.dev/color-scheme/. diff --git a/docs/troubleshooting/native.md b/docs/troubleshooting/native.md index b757c5d0d59..bdaf0c244eb 100644 --- a/docs/troubleshooting/native.md +++ b/docs/troubleshooting/native.md @@ -38,12 +38,12 @@ Running an app on an iOS device requires a provisioning profile. If a provisioni 3. In Project navigator, select the project root to open the project editor. Under the **Identity** section, verify that the Package ID that was set matches the Bundle Identifier. - ![Xcode Identity Setup](/img/running/ios-xcode-identity-setup.png) + ![Xcode showing the Identity section for an iOS app with fields for Display Name, Bundle Identifier, Version, and Build.](/img/running/ios-xcode-identity-setup.png "Xcode Identity Section") 4. In the same project editor, under the Signing section, ensure Automatically manage signing is enabled. Then, select a Development Team. Given a Development Team, Xcode will attempt to automatically prepare provisioning and signing. - ![Xcode Signing Setup](/img/running/ios-xcode-signing-setup.png) + ![Xcode showing the Signing section with 'Automatically manage signing' enabled and a Development Team selected.](/img/running/ios-xcode-signing-setup.png "Xcode Signing Section") ## Xcode build error 65 diff --git a/docs/vue/quickstart.md b/docs/vue/quickstart.md index 25acbd0062e..390b7781ba1 100644 --- a/docs/vue/quickstart.md +++ b/docs/vue/quickstart.md @@ -189,7 +189,7 @@ Now the `App` component does not really have a lot to modify here. It is a basic Currently, the `Home` component looks like so: -![Vue home component](/img/guides/vue/first-app/home-route.png) +![A web browser displaying the Ionic Vue home route with a header titled 'Blank' and a message 'Ready to create an app? Start with Ionic UI Components'.](/img/guides/vue/first-app/home-route.png 'Ionic Vue Home Route Interface') ```html