Skip to content

Commit d9ac5ab

Browse files
committed
Update setup dev tenant steps
Added details to the doc addressing diferences between classic & modern sp admin centers - fixes SharePoint#4007
1 parent 24610b8 commit d9ac5ab

File tree

1 file changed

+43
-20
lines changed

1 file changed

+43
-20
lines changed

docs/spfx/set-up-your-developer-tenant.md

Lines changed: 43 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -9,75 +9,98 @@ localization_priority: Priority
99

1010
# Set up your Office 365 tenant
1111

12-
To build and deploy client-side web parts using the SharePoint Framework, you need an Office 365 tenant.
12+
To build and deploy client-side web parts using the SharePoint Framework, you need an Office 365 tenant.
1313

1414
If you already have an Office 365 tenant, see the section [Create app catalog site](#create-app-catalog-site).
1515

1616
If you don't have one, you can get an Office 365 developer subscription when you join the [Office 365 Developer Program](https://developer.microsoft.com/en-us/office/dev-program). See the [Office 365 Developer Program documentation](https://docs.microsoft.com/en-us/office/developer-program/office-365-developer-program) for step-by-step instructions about how to join the Office 365 Developer Program and sign up and configure your subscription.
1717

18-
> [!NOTE]
18+
> [!NOTE]
1919
> Make sure that you are signed out of any existing Office 365 tenants before you sign up for the Office 365 Developer Program.
2020
2121
## Create app catalog site
2222

2323
You need an app catalog to upload and deploy web parts. If you've already set up an app catalog, see [create a new developer site collection](#create-a-new-developer-site-collection).
2424

25+
> [!NOTE]
26+
> The following steps assume you are using the Classic SharePoint Admin Center. At this time, the modern SharePoint Admin Center does not have native support for creating an App Catalog. You can access the Classic SharePoint Admin Center from the left sidebar of the SharePoint Admin Center.
27+
2528
### To create an app catalog site
2629

27-
1. Go to the **SharePoint Admin Center** by entering the following URL in your browser. Replace **yourtenantprefix** with your Office 365 tenant prefix.
28-
29-
```
30+
1. Go to the **Classic SharePoint Admin Center** by entering the following URL in your browser. Replace **yourtenantprefix** with your Office 365 tenant prefix.
31+
32+
```http
3033
https://yourtenantprefix-admin.sharepoint.com
3134
```
32-
33-
2. In the left sidebar, select the **apps** menu item, and then select **app catalog**.
34-
35-
3. Select **OK** to create a new app catalog site.
3635
37-
4. On the next page, enter the following details:
36+
1. In the left sidebar, select the **apps** menu item, and then select **app catalog**.
37+
1. Select **OK** to create a new app catalog site.
38+
1. On the next page, enter the following details:
3839
3940
- **Title**: Enter **app catalog**.
4041
- **Web Site Address _suffix_**: Enter your preferred suffix for the app catalog; for example: **apps**.
4142
- **Administrator**: Enter your username, and then select the **resolve** button to resolve the username.
4243
43-
5. Select **OK** to create the app catalog site.
44+
1. Select **OK** to create the app catalog site.
4445
4546
SharePoint creates the app catalog site, and you are able to see its progress in the SharePoint admin center.
4647
4748
## Create a new developer site collection
4849
4950
You also need a site collection and a site for your testing. You can create a new site collection by using any of the available templates. You may choose to use **developer site collection**, but that does not really add additional value because workbench and basic testing can be performed under any site.
5051
52+
> [!NOTE]
53+
> You can only create a "developer site collection", a special site template used when creating & testing SharePoint add-ins from the Classic SharePoint Admin Center. If you are using the Modern SharePoint Admin Center, you can create a Team Site and use it for development purposes. You can use any SharePoint site for SharePoint Framework development.
54+
5155
### To create a new developer site collection
5256
53-
1. Go to the **SharePoint Admin Center** by entering the following URL in your browser. Replace **yourtenantprefix** with your Office 365 tenant prefix.
54-
55-
```
57+
1. Go to the **Classic SharePoint Admin Center** by entering the following URL in your browser. Replace **yourtenantprefix** with your Office 365 tenant prefix.
58+
59+
```http
5660
https://yourtenantprefix-admin.sharepoint.com
5761
```
58-
59-
2. On the SharePoint ribbon, select **New** > **Private Site Collection**.
6062
61-
3. In the dialog box, enter the following details:
63+
1. On the SharePoint ribbon, select **New** > **Private Site Collection**.
64+
1. In the dialog box, enter the following details:
6265
6366
- **Title**: Enter a title for your developer site collection; for example: **Developer Site**.
6467
- **Web Site Address _suffix_**: Enter a suffix for your developer site collection; for example: **dev**.
6568
- **Template Selection**: Select **Developer Site** as the site collection template.
6669
- **Administrator**: Enter your username, and then select the **resolve** button to resolve the username.
6770
68-
4. Select **OK** to create the site collection.
71+
1. Select **OK** to create the site collection.
6972
7073
SharePoint creates the developer site and you are able to see its progress in the SharePoint admin center. After the site is created, you can browse to your developer site collection.
7174
72-
> Notice that technically you can use any SharePoint site for SharePoint Framework development. In this case we simply created an isolated developer site collection for initial testing.
75+
### To create a new team site
76+
77+
1. Go to the **SharePoint Admin Center** by entering the following URL in your browser. Replace **yourtenantprefix** with your Office 365 tenant prefix.
78+
79+
```http
80+
https://yourtenantprefix-admin.sharepoint.com/_layouts/15/online/AdminHome.aspx
81+
```
82+
83+
1. In the left sidebar, select **Sites > Active Sites**.
84+
1. In the toolbar, select **Create**.
85+
1. In the **Create a site** dialog, select **Team site**.
86+
1. In the panel that appears, enter the following details:
87+
88+
- **Site name**: Enter a title for your site; for example: **Developer Site**.
89+
- **Group email address**: Accept the default option or modify it.
90+
- **Group owner**: Specify the name / email address of the site owner.
91+
- **Select a language**: Accept the default language or modify it.
92+
93+
1. Select **Next** to create the site collection.
94+
95+
SharePoint creates the site. After the site is created, you can browse to your new site.
7396
7497
## SharePoint Workbench
7598
7699
SharePoint Workbench is a developer design surface that enables you to quickly preview and test web parts without deploying them in SharePoint. SharePoint Framework developer toolchain contains a version of the Workbench that works locally and helps you quickly test and validate solutions that you are building.
77100
78101
It is also hosted in your tenant to preview and test your local web parts in development. You can access the SharePoint Workbench from any SharePoint site in your tenancy by browsing to the following URL:
79102
80-
```
103+
```http
81104
https://your-sharepoint-site/_layouts/workbench.aspx
82105
```
83106

0 commit comments

Comments
 (0)