You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/spfx/set-up-your-developer-tenant.md
+43-20Lines changed: 43 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -9,75 +9,98 @@ localization_priority: Priority
9
9
10
10
# Set up your Office 365 tenant
11
11
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.
13
13
14
14
If you already have an Office 365 tenant, see the section [Create app catalog site](#create-app-catalog-site).
15
15
16
16
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.
17
17
18
-
> [!NOTE]
18
+
> [!NOTE]
19
19
> Make sure that you are signed out of any existing Office 365 tenants before you sign up for the Office 365 Developer Program.
20
20
21
21
## Create app catalog site
22
22
23
23
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).
24
24
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
+
25
28
### To create an app catalog site
26
29
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
30
33
https://yourtenantprefix-admin.sharepoint.com
31
34
```
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.
36
35
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:
38
39
39
40
- **Title**: Enter **app catalog**.
40
41
- **Web Site Address _suffix_**: Enter your preferred suffix for the app catalog; for example: **apps**.
41
42
- **Administrator**: Enter your username, and then select the **resolve** button to resolve the username.
42
43
43
-
5. Select **OK** to create the app catalog site.
44
+
1. Select **OK** to create the app catalog site.
44
45
45
46
SharePoint creates the app catalog site, and you are able to see its progress in the SharePoint admin center.
46
47
47
48
## Create a new developer site collection
48
49
49
50
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.
50
51
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
+
51
55
### To create a new developer site collection
52
56
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
56
60
https://yourtenantprefix-admin.sharepoint.com
57
61
```
58
-
59
-
2. On the SharePoint ribbon, select **New** > **Private Site Collection**.
60
62
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:
62
65
63
66
- **Title**: Enter a title for your developer site collection; for example: **Developer Site**.
64
67
- **Web Site Address _suffix_**: Enter a suffix for your developer site collection; for example: **dev**.
65
68
- **Template Selection**: Select **Developer Site** as the site collection template.
66
69
- **Administrator**: Enter your username, and then select the **resolve** button to resolve the username.
67
70
68
-
4. Select **OK** to create the site collection.
71
+
1. Select **OK** to create the site collection.
69
72
70
73
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.
71
74
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.
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.
73
96
74
97
## SharePoint Workbench
75
98
76
99
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.
77
100
78
101
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:
0 commit comments