diff --git a/gatsby-node.js b/gatsby-node.js index a55fc3b2d8..81ccb7742d 100755 --- a/gatsby-node.js +++ b/gatsby-node.js @@ -7,8 +7,6 @@ exports.onCreateNode = ({ node, getNode, actions }) => { const { createNodeField } = actions; // If the node type (file) is a markdown file if (node.internal.type === 'Mdx') { - const dir = path.resolve(__dirname, ''); - const fileNode = getNode(node.parent); const slug = createFilePath({ node, getNode, @@ -102,10 +100,78 @@ exports.createPages = ({ actions, graphql }) => { } } }); + + [ + { + fromPaths: [ + '/tutorial/overview', + '/tutorial/overview/', + '/tutorial/overview/index.html', + ], + toPath: '/tutorial/react/overview', + }, + { + fromPaths: [ + '/tutorial/react-step-1', + '/tutorial/react-step-1/', + '/tutorial/react-step-1/index.html', + ], + toPath: '/tutorial/react/step-1', + }, + { + fromPaths: [ + '/tutorial/react-step-2', + '/tutorial/react-step-2/', + '/tutorial/react-step-2/index.html', + ], + toPath: '/tutorial/react/step-2', + }, + { + fromPaths: [ + '/tutorial/react-step-3', + '/tutorial/react-step-3/', + '/tutorial/react-step-3/index.html', + ], + toPath: '/tutorial/react/step-3', + }, + { + fromPaths: [ + '/tutorial/react-step-4', + '/tutorial/react-step-4/', + '/tutorial/react-step-4/index.html', + ], + toPath: '/tutorial/react/step-4', + }, + { + fromPaths: [ + '/tutorial/react-step-5', + '/tutorial/react-step-5/', + '/tutorial/react-step-5/index.html', + ], + toPath: '/tutorial/react/step-5', + }, + { + fromPaths: [ + '/tutorial/wrapping-up', + '/tutorial/wrapping-up/', + '/tutorial/wrapping-up/index.html', + ], + toPath: '/tutorial/react/wrapping-up', + }, + ].forEach(redirect => { + redirect.fromPaths.forEach(fromPath => { + createRedirect({ + redirectInBrowser: true, + isPermanent: true, + fromPath, + toPath: redirect.toPath, + }); + }); + }); }); }; -exports.onCreateWebpackConfig = ({ actions, getConfig, stage, loaders }) => { +exports.onCreateWebpackConfig = ({ actions, loaders }) => { actions.setWebpackConfig({ module: { rules: [ @@ -135,6 +201,7 @@ exports.onPostBuild = () => { try { src = path.resolve(path.dirname(require.resolve('carbon-icons')), 'svg'); } catch (err) { + /* eslint-disable-next-line no-console */ console.error('Error locating the icons directory', err.stack); return; } diff --git a/src/content/tutorial/wrapping-up/images/carbon-badge.png b/src/content/tutorial/react/images/carbon-badge.png similarity index 100% rename from src/content/tutorial/wrapping-up/images/carbon-badge.png rename to src/content/tutorial/react/images/carbon-badge.png diff --git a/src/content/tutorial/overview/overview.mdx b/src/content/tutorial/react/overview.mdx similarity index 89% rename from src/content/tutorial/overview/overview.mdx rename to src/content/tutorial/react/overview.mdx index e137d99c12..7dc179d14d 100644 --- a/src/content/tutorial/overview/overview.mdx +++ b/src/content/tutorial/react/overview.mdx @@ -1,6 +1,8 @@ --- title: Tutorial overview internal: false +tabs: + ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### Welcome to Carbon! This tutorial will guide you in creating a React app with the Carbon Design System. We'll teach you the ins and outs of using Carbon components, while introducing web development best practices along the way. @@ -55,13 +57,13 @@ This tutorial uses [Yarn](https://yarnpkg.com) for dependency management so we c Each step in this tutorial illustrates a different aspect of developing web applications with Carbon. We recommend starting with step 1, but you can pick up any step and take it from there. -1. [**Installing Carbon**](/tutorial/react-step-1) +1. [**Installing Carbon**](/tutorial/step-1/react) - Create a web app with the UI shell component. -1. [**Building pages**](/tutorial/react-step-2) +1. [**Building pages**](/tutorial/step-2/react) - Build out pages with the grid and various components. -1. [**Using APIs**](/tutorial/react-step-3) +1. [**Using APIs**](/tutorial/step-3/react) - Populate the data table with an external data source. -1. [**Creating components**](/tutorial/react-step-4) +1. [**Creating components**](/tutorial/step-4/react) - Extend Carbon by creating your own components. -1. [**Deploying to IBM Cloud**](/tutorial/react-step-5) +1. [**Deploying to IBM Cloud**](/tutorial/step-5/react) - Build and host your app in a production environment. diff --git a/src/content/tutorial/react-step-1/react-step-1.mdx b/src/content/tutorial/react/step-1.mdx similarity index 97% rename from src/content/tutorial/react-step-1/react-step-1.mdx rename to src/content/tutorial/react/step-1.mdx index 5b82fddcfe..97797644fc 100644 --- a/src/content/tutorial/react-step-1/react-step-1.mdx +++ b/src/content/tutorial/react/step-1.mdx @@ -1,6 +1,7 @@ --- title: 1. Installing Carbon internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### Starting with Create React App, let's install Carbon and begin using Carbon components. By the end you will have a React app that uses the UI Shell to navigate between pages. @@ -589,6 +590,6 @@ _Note: If you receive a_ `non-fast-forward` _error, it's likely that your forked ### Pull request (PR) -Finally, visit [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) to "Compare & pull request". In doing so, make sure that you are comparing to `react-step-1` into `base: react-step-1`. Take notice of the [Netlify](https://www.netlify.com) bot that deploys a preview of your PR every time that you push new commits. These previews can be shared and viewed by anybody to assist the PR review process. +Finally, visit [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) to "Compare & pull request". In doing so, make sure that you are comparing your forked repository's `react-step-1` branch into `base: react-step-1`. Take notice of the [Netlify](https://www.netlify.com) bot that deploys a preview of your PR every time that you push new commits. These previews can be shared and viewed by anybody to assist the PR review process. _Note: Expect your tutorial step PRs to be reviewed by the Carbon team but not merged. We'll close your PR so we can keep the repository's remote branches pristine and ready for the next person!_ diff --git a/src/content/tutorial/react-step-2/react-step-2.mdx b/src/content/tutorial/react/step-2.mdx similarity index 97% rename from src/content/tutorial/react-step-2/react-step-2.mdx rename to src/content/tutorial/react/step-2.mdx index 667ce04ab1..6bc8e93259 100644 --- a/src/content/tutorial/react-step-2/react-step-2.mdx +++ b/src/content/tutorial/react/step-2.mdx @@ -1,6 +1,7 @@ --- title: 2. Building pages internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### Now that we have a React app using the UI Shell, it's time to build a few static pages. In this step, we'll become comfortable with the Carbon grid and various Carbon components. @@ -39,7 +40,7 @@ A [preview](https://react-step-3--carbon-tutorial.netlify.com) of what you'll bu ## Fork, clone and branch -This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/react-step-1#fork-clone--branch). +This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/step-1/react#fork-clone--branch). ### Branch @@ -66,7 +67,7 @@ Then, start the app: $ yarn start ``` -You should see something similar to where the [previous step](/tutorial/react-step-1) left off. +You should see something similar to where the [previous step](/tutorial/step-1/react) left off. ### IE11 polyfills @@ -119,7 +120,7 @@ We've included the designs for this tutorial app in the `design.sketch` file fou -![Landing page grid](/images/landing-layout.png) +![Landing page grid](../shared/step-2/images/landing-layout.png) @@ -387,7 +388,7 @@ We've added basic layout styles in `_landing-page.scss`, so now let's add type, -![Banner vertical spacing](/images/landing-r1-spacing.png) +![Banner vertical spacing](../shared/step-2/images/landing-r1-spacing.png) @@ -455,7 +456,7 @@ Next, we can see that the `h1` is using the `heading-05` type token. -![Banner heading type](/images/landing-r1-type.png) +![Banner heading type](../shared/step-2/images/landing-r1-type.png) @@ -485,7 +486,7 @@ We also need to adjust our vertical spacing and type treatment. Like before, it' -![Row 2 vertical spacing](/images/landing-r2-spacing.png) +![Row 2 vertical spacing](../shared/step-2/images/landing-r2-spacing.png) @@ -519,7 +520,7 @@ _Note: You may be wondering why there are vertical gaps between the type and spa -![Row 3 vertical spacing](/images/landing-r3-spacing.png) +![Row 3 vertical spacing](../shared/step-2/images/landing-r3-spacing.png) @@ -759,7 +760,7 @@ Run the CI check to make sure we're all set to submit a pull request. $ yarn ci-check ``` -_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ +_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ ### Git commit and push @@ -775,7 +776,7 @@ Then, push to your repository: $ git push origin react-step-2 ``` -_Note: Having issues pushing your changes? [Step 1](/tutorial/react-step-1#git-commit-and-push) has troubleshooting notes that may help._ +_Note: Having issues pushing your changes? [Step 1](/tutorial/step-1/react#git-commit-and-push) has troubleshooting notes that may help._ ### Pull request (PR) diff --git a/src/content/tutorial/react-step-3/react-step-3.mdx b/src/content/tutorial/react/step-3.mdx similarity index 97% rename from src/content/tutorial/react-step-3/react-step-3.mdx rename to src/content/tutorial/react/step-3.mdx index dc0c008896..c3234fd413 100644 --- a/src/content/tutorial/react-step-3/react-step-3.mdx +++ b/src/content/tutorial/react/step-3.mdx @@ -1,6 +1,7 @@ --- title: 3. Using APIs internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### This step takes our static components and populates them with data from the GitHub GraphQL API – loading states and all. We'll be displaying Carbon repository information in a data table. @@ -43,7 +44,7 @@ A [preview](https://react-step-4--carbon-tutorial.netlify.com) of what you will ## Fork, clone and branch -This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/react-step-1#fork-clone--branch). +This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/step-1/react#fork-clone--branch). ### Branch @@ -68,7 +69,7 @@ Then, start the app: $ yarn start ``` -You should see something similar to where the [previous step](/tutorial/react-step-2) left off. Stop your app with `CTRL-C` and let's get everything installed. +You should see something similar to where the [previous step](/tutorial/step-2/react) left off. Stop your app with `CTRL-C` and let's get everything installed. ## Install dependencies @@ -487,7 +488,7 @@ Run the CI check to make sure we're all set to submit a pull request. $ yarn ci-check ``` -_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ +_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ ### Git commit and push @@ -503,7 +504,7 @@ Then, push to your repository: $ git push origin react-step-3 ``` -_Note: Having issues pushing your changes? [Step 1](/tutorial/react-step-1#git-commit-and-push) has troubleshooting notes that may help._ +_Note: Having issues pushing your changes? [Step 1](/tutorial/step-1/react#git-commit-and-push) has troubleshooting notes that may help._ ### Pull request (PR) diff --git a/src/content/tutorial/react-step-4/react-step-4.mdx b/src/content/tutorial/react/step-4.mdx similarity index 95% rename from src/content/tutorial/react-step-4/react-step-4.mdx rename to src/content/tutorial/react/step-4.mdx index 8969848a1c..1807fd92ad 100644 --- a/src/content/tutorial/react-step-4/react-step-4.mdx +++ b/src/content/tutorial/react/step-4.mdx @@ -1,6 +1,7 @@ --- title: 4. Creating components internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### With two pages comprised entirely of Carbon components, let's revisit the landing page and build a couple components of our own by using Carbon icons and tokens. @@ -41,7 +42,7 @@ A [preview](https://react-step-5--carbon-tutorial.netlify.com) of what you'll bu ## Fork, clone and branch -This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/react-step-1#fork-clone--branch). +This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/step-1/react#fork-clone--branch). ### Branch @@ -68,7 +69,7 @@ Then, start the app: $ yarn start ``` -You should see something similar to where the [previous step](/tutorial/react-step-3) left off. +You should see something similar to where the [previous step](/tutorial/step-3/react) left off. ## Review design @@ -76,7 +77,7 @@ Here's what we're building – an informational section that has a heading and t -![Info section layout](/images/info-layout.png) +![Info section layout](../shared/step-4/images/info-layout.png) @@ -265,7 +266,7 @@ Here's our design showing the spacing tokens that we need to add. We also need t -![Info section spacing](/images/info-spacing.png) +![Info section spacing](../shared/step-4/images/info-spacing.png) @@ -385,7 +386,7 @@ With the browser extension installed, Chrome in this example, open Dev Tools and -![DAP violations](/images/DAP-violations.png) +![DAP violations](../shared/step-4/images/DAP-violations.png) @@ -407,7 +408,7 @@ Run the CI check to make sure we're all set to submit a pull request. $ yarn ci-check ``` -_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ +_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ ### Git commit and push @@ -423,7 +424,7 @@ Then, push to your repository: $ git push origin react-step-4 ``` -_Note: Having issues pushing your changes? [Step 1](/tutorial/react-step-1#git-commit-and-push) has troubleshooting notes that may help._ +_Note: Having issues pushing your changes? [Step 1](/tutorial/step-1/react#git-commit-and-push) has troubleshooting notes that may help._ ### Pull request (PR) diff --git a/src/content/tutorial/react-step-5/react-step-5.mdx b/src/content/tutorial/react/step-5.mdx similarity index 85% rename from src/content/tutorial/react-step-5/react-step-5.mdx rename to src/content/tutorial/react/step-5.mdx index b0838b3871..e3c83e6512 100644 --- a/src/content/tutorial/react-step-5/react-step-5.mdx +++ b/src/content/tutorial/react/step-5.mdx @@ -1,6 +1,7 @@ --- title: 5. Deploying to IBM Cloud internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- ### This step takes what we've built so far and optimizes the app for a production environment. We'll be deploying the production build to IBM Cloud. @@ -38,7 +39,7 @@ A [preview](https://react-step-6--carbon-tutorial.netlify.com) of what you'll bu ## Fork, clone and branch -This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/react-step-1#fork-clone--branch). +This tutorial has an accompanying GitHub repository called [carbon-tutorial](https://github.com/carbon-design-system/carbon-tutorial) that we'll use as a starting point for each step. If you haven't forked and cloned that repository yet, and haven't added the upstream remote, go ahead and do so by following the [step 1 instructions](/tutorial/step-1/react#fork-clone--branch). ### Branch @@ -65,7 +66,7 @@ Then, start the app: $ yarn start ``` -You should see something similar to where the [previous step](/tutorial/react-step-4) left off. +You should see something similar to where the [previous step](/tutorial/step-4/react) left off. ## Create IBM Cloud account @@ -127,11 +128,11 @@ As a lot of this may seem like magic since the build configuration came from Cre ## Create manifest file -Now that we have a production build, let's get it on the cloud. We're going to use [staticfile-buildpack](https://github.com/cloudfoundry/staticfile-buildpack.git) to deploy our webapp. Since this is a Cloud Foundry buildpack, we'll be using the `cf` command line interface (CLI). If running `cf --help` doesn't work for you, chances are you need to [install the CLI](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html). +Now that we have a production build, let's get it on the cloud. We're going to use [staticfile-buildpack](https://github.com/cloudfoundry/staticfile-buildpack.git) to deploy our webapp. We'll be using the `ibmcloud` command line interface (CLI). If running `ibmcloud help` doesn't work for you, chances are you need to [install the CLI](https://cloud.ibm.com/docs/cli?topic=cloud-cli-install-ibmcloud-cli). _Note: If unfamiliar with buildpacks, the [staticfile buildpack docs](https://docs.cloudfoundry.org/buildpacks/staticfile/index.html) has good definitions and configuration documentation._ -With the Cloud Foundry CLI installed, next, we need to create a `manifest.yml` file in the root of the project. To prevent multiple apps trying to use the `carbon-tutorial` name, replace `USERNAME` with your GitHub username below to make sure our apps are uniquely named. +With the IBM Cloud CLI installed, next, we need to create a `manifest.yml` file in the root of the project. To prevent multiple apps trying to use the `carbon-tutorial` name, replace `USERNAME` with your GitHub username below to make sure our apps are uniquely named. ##### manifest.yml @@ -143,7 +144,7 @@ applications: buildpack: https://github.com/cloudfoundry/staticfile-buildpack.git ``` -_Note: With this set-up we're still using a GitHub personal access token saved in _`.env.local`_. If you haven't created a GitHub access token yet, see [step 3](/tutorial/react-step-3#create-access-token). You can put the environment variable in the manifest file, or manually add it in the IBM Cloud dashboard, but since we're building off previous tutorial steps nothing more is needed._ +_Note: With this set-up we're still using a GitHub personal access token saved in _`.env.local`_. If you haven't created a GitHub access token yet, see [step 3](/tutorial/step-3/react#create-access-token). You can put the environment variable in the manifest file, or manually add it in the IBM Cloud dashboard, but since we're building off previous tutorial steps nothing more is needed._ ## Create static file @@ -165,14 +166,14 @@ After telling Cloud Foundry what to include, we can also specify what to ignore. node_modules/.cache ``` -You can speed up deploys by decreasing the files uploaded through cloud foundry. To accomplish this, ignore any folder not required by the production application on IBM Cloud. For example, in the case of serving static files, you can ignore `node_modules/` and `src/` because the only folder being served is `build/`. +You can speed up deploys by decreasing the files uploaded through IBM Cloud. To accomplish this, ignore any folder not required by the production application on IBM Cloud. For example, in the case of serving static files, you can ignore `node_modules/` and `src/` because the only folder being served is `build/`. ## Deploy app -Login to IBM Cloud with: +Login to IBM Cloud. ```bash -$ cf login -a https://api.ng.bluemix.net -sso +$ cf login -sso ``` Deploy app using the `cf push` command. Since `manifest.yml` is in our root directory, we don't need to specify it in the push command. But, if you have multiple manifest files that target different environments, it's good practice to specify the file. @@ -186,7 +187,7 @@ To make it easy on ourselves by not needing to remember that command, let's add ##### package.json ```bash -"deploy": "rm -rf ./build && yarn build && cf push -f manifest.yml" +"deploy": "rm -rf ./build && yarn build && ibmcloud cf push -f manifest.yml" ``` Next time you want to deploy, you can simply run `yarn deploy`. @@ -203,7 +204,7 @@ Run the CI check to make sure we're all set to submit a pull request. $ yarn ci-check ``` -_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ +_Note: Having issues running the CI check? [Step 1]() has troubleshooting notes that may help._ ### Git commit and push @@ -219,7 +220,7 @@ Then, push to your repository: $ git push origin react-step-5 ``` -_Note: Having issues pushing your changes? [Step 1](/tutorial/react-step-1#git-commit-and-push) has troubleshooting notes that may help._ +_Note: Having issues pushing your changes? [Step 1](/tutorial/step-1/react#git-commit-and-push) has troubleshooting notes that may help._ ### Pull request (PR) diff --git a/src/content/tutorial/wrapping-up/wrapping-up.mdx b/src/content/tutorial/react/wrapping-up.mdx similarity index 67% rename from src/content/tutorial/wrapping-up/wrapping-up.mdx rename to src/content/tutorial/react/wrapping-up.mdx index 10e4f77d61..1030f611fc 100644 --- a/src/content/tutorial/wrapping-up/wrapping-up.mdx +++ b/src/content/tutorial/react/wrapping-up.mdx @@ -1,13 +1,14 @@ --- title: Wrapping up +tabs: + ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] --- -### Thanks for completing our tutorial and helping us improve it along the way. As a way to say thanks, you can apply for an IBM Digital Badge and a free shirt! +### Thanks for completing our tutorial and helping us improve it along the way. You can now apply for an IBM Digital Badge! - [Badging](#badging) -- [Free t-shirt\*](#free-t-shirt) - [Application](#application) @@ -18,7 +19,7 @@ Once you complete all five steps of the tutorial, you can apply for the IBM Digi -![](/images/carbon-badge.png) +![](../shared/wrapping-up/images/carbon-badge.png) @@ -27,13 +28,14 @@ Once you complete all five steps of the tutorial, you can apply for the IBM Digi This badge demonstrates knowledge about Carbon's React components. To earn the badge: 1. Complete steps 1 through 5 of the React Carbon tutorial - - Step 1. [Installing Carbon](/tutorial/react-step-1) - - Step 2. [Building pages](/tutorial/react-step-2) - - Step 3. [Using APIs](/tutorial/react-step-3) - - Step 4. [Creating components](/tutorial/react-step-4) - - Step 5. [Deploying to IBM Cloud](/tutorial/react-step-5) + - Step 1. [Installing Carbon](/tutorial/step-1/react) + - Step 2. [Building pages](/tutorial/step-2/react) + - Step 3. [Using APIs](/tutorial/step-3/react) + - Step 4. [Creating components](/tutorial/step-4/react) + - Step 5. [Deploying to IBM Cloud](/tutorial/step-5/react) 2. Submit links to approved pull requests for steps 1 through 5 of the React Carbon tutorial in the [carbon-tutorial repository](https://github.com/carbon-design-system/carbon-tutorial). - To quickly find your submitted PRs, you can [filter by author](https://github.com/carbon-design-system/carbon-tutorial/pulls?utf8=%E2%9C%93&q=author%3Ausername) (e.g. `author:${username}`) +3. Complete the [badge application](http://www.carbondesignsystem.com/tutorial/wrapping-up/react#application) ### FAQ and help @@ -45,18 +47,6 @@ Acclaim Support: For questions related to your Acclaim badge earner account and NOTICE: IBM leverages the services of Credly's Acclaim platform, a 3rd party data processor authorized by IBM and located in the United States, to assist in the administration of the IBM Digital Badge program. In order to issue you an IBM Digital Badge, your personal information (name, email address, and badge earned) will be shared with the Credly's Acclaim platform. You will receive an email notification from Acclaim with instructions for claiming the badge. Your personal information is used to issue your badge and for program reporting and operational purposes. It will be handled in a manner consistent with IBM privacy practices. The IBM Privacy Statement can be viewed here: [https://www.ibm.com/privacy/us/en/](https://www.ibm.com/privacy/us/en/). IBM employees can view the IBM Internal Privacy Statement here: [https://w3.ibm.com/w3publisher/w3-privacy-notice](https://w3.ibm.com/w3publisher/w3-privacy-notice). -## Free t-shirt - -Submit your completed IBM Digital Badge application by July 30, 2019, and receive a free\* Carbon t-shirt. - - - -![](/images/carbon-tee.png) - - - ## Application -Complete the [application form](https://www.surveygizmo.com/s3/5075530/Dev-Essentials-Badge-Application) to request the digital badge and t-shirt. Once you submit the application, please allow 2-4 days for issuing the badge and 4-6 weeks to receive the t-shirt. Once the badge is issued, you will be notified and must accept the badge via Acclaim. - -_\* Shirts are available for a limited time while supplies last to U.S. shipping addresses and outside the U.S. to participating FED@IBM branches._ +Complete the [application form](https://www.surveygizmo.com/s3/5163103/IBM-Carbon-Design-System-Developer-Essentials-React-v2) to request the digital badge. Once you submit the application, please allow 2-4 days for issuing the badge. Once the badge is issued, you will be notified and must accept the badge via Acclaim. diff --git a/src/content/tutorial/react-step-2/images/landing-layout.png b/src/content/tutorial/shared/step-2/images/landing-layout.png similarity index 100% rename from src/content/tutorial/react-step-2/images/landing-layout.png rename to src/content/tutorial/shared/step-2/images/landing-layout.png diff --git a/src/content/tutorial/react-step-2/images/landing-r1-spacing.png b/src/content/tutorial/shared/step-2/images/landing-r1-spacing.png similarity index 100% rename from src/content/tutorial/react-step-2/images/landing-r1-spacing.png rename to src/content/tutorial/shared/step-2/images/landing-r1-spacing.png diff --git a/src/content/tutorial/react-step-2/images/landing-r1-type.png b/src/content/tutorial/shared/step-2/images/landing-r1-type.png similarity index 100% rename from src/content/tutorial/react-step-2/images/landing-r1-type.png rename to src/content/tutorial/shared/step-2/images/landing-r1-type.png diff --git a/src/content/tutorial/react-step-2/images/landing-r2-spacing.png b/src/content/tutorial/shared/step-2/images/landing-r2-spacing.png similarity index 100% rename from src/content/tutorial/react-step-2/images/landing-r2-spacing.png rename to src/content/tutorial/shared/step-2/images/landing-r2-spacing.png diff --git a/src/content/tutorial/react-step-2/images/landing-r3-spacing.png b/src/content/tutorial/shared/step-2/images/landing-r3-spacing.png similarity index 100% rename from src/content/tutorial/react-step-2/images/landing-r3-spacing.png rename to src/content/tutorial/shared/step-2/images/landing-r3-spacing.png diff --git a/src/content/tutorial/react-step-4/images/DAP-violations.png b/src/content/tutorial/shared/step-4/images/DAP-violations.png similarity index 100% rename from src/content/tutorial/react-step-4/images/DAP-violations.png rename to src/content/tutorial/shared/step-4/images/DAP-violations.png diff --git a/src/content/tutorial/react-step-4/images/info-layout.png b/src/content/tutorial/shared/step-4/images/info-layout.png similarity index 100% rename from src/content/tutorial/react-step-4/images/info-layout.png rename to src/content/tutorial/shared/step-4/images/info-layout.png diff --git a/src/content/tutorial/react-step-4/images/info-spacing.png b/src/content/tutorial/shared/step-4/images/info-spacing.png similarity index 100% rename from src/content/tutorial/react-step-4/images/info-spacing.png rename to src/content/tutorial/shared/step-4/images/info-spacing.png diff --git a/src/content/tutorial/wrapping-up/images/carbon-tee.png b/src/content/tutorial/shared/wrapping-up/images/carbon-tee.png similarity index 100% rename from src/content/tutorial/wrapping-up/images/carbon-tee.png rename to src/content/tutorial/shared/wrapping-up/images/carbon-tee.png diff --git a/src/content/tutorial/vue/images/carbon-badge-vue.png b/src/content/tutorial/vue/images/carbon-badge-vue.png new file mode 100644 index 0000000000..56b9dd7b94 Binary files /dev/null and b/src/content/tutorial/vue/images/carbon-badge-vue.png differ diff --git a/src/content/tutorial/vue/overview.mdx b/src/content/tutorial/vue/overview.mdx new file mode 100644 index 0000000000..b9574c335e --- /dev/null +++ b/src/content/tutorial/vue/overview.mdx @@ -0,0 +1,68 @@ +--- +title: Tutorial overview +internal: false +tabs: ['Overview', 'Step 1', 'Step 2', 'Step 3', 'Step 4', 'Step 5', 'Wrapping up'] +--- + +### Welcome to Carbon! This tutorial will guide you in creating a Vue app with the Carbon Design System. We'll teach you the ins and outs of using Carbon components, while introducing web development best practices along the way. + + + +- [Audience](#audience) +- [Prerequisites](#prerequisites) +- [Outline](#outline) + + + +Here's a [preview](https://vue-step-6--carbon-tutorial-vue.netlify.com) of what you will build: + + + +