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
description: 'Starlight is a documentation website framework built with Astro that helps you build beautiful, high-performance documentation sites with minimal setup.'
Starlight is a modern documentation framework built on top of Astro that makes it easy to create beautiful, high-performance documentation websites. Built with Astro and powered by Markdown, Starlight helps you focus on writing content while taking care of the technical details.
28
+
29
+
With Appwrite Sites, you can deploy your Starlight documentation in minutes using our pre-built template, with features like automatic builds, custom domains, and global CDN distribution.
30
+
31
+
# How does the integration work?
32
+
33
+
[Appwrite Sites](https://appwrite.io/products/sites) provides a ready-to-use Starlight template that you can deploy instantly. The template comes with a pre-configured setup optimized for documentation sites, making it easy to get started without any complex configuration.
34
+
35
+
36
+
To deploy the Starlight template with Appwrite Sites, follow these steps:
37
+
38
+
## Create site
39
+
40
+
After signing into your Appwrite console, look at the sidebar on the left. Under the **Deploy** section, you will find the **Sites** button.
41
+
42
+
Clicking it opens the Sites page. Here, you will see the **Sites** tab selected by default. Click **Create site** to start the deployment process.
43
+
44
+
45
+
46
+
At this point, Appwrite offers two options: **Clone a template** or **Connect a repository**. For this guide, we will focus on cloning the Starlight template, which lets you quickly set up a documentation site based on a pre-built project.
47
+
48
+
49
+
50
+
## Finding the Starlight template
51
+
52
+
When you select **Clone a template**, you'll see a library of templates. To find the Starlight template:
53
+
54
+
1. Use the search bar at the top and type "Starlight"
After selecting the template, you'll need to choose how to deploy it, Clicking the Starlight template will open a new page where you can configure your documentation site.
60
+
61
+
62
+
63
+
## Configuring your site
64
+
65
+
### Setting up site details
66
+
67
+
Once you have selected the Starlight template, you will be prompted to enter basic details for your site.
68
+
69
+
You will need to provide a **Site name** and a **Site ID**. The Site ID becomes part of your site's URL, so it should be lowercase and use hyphens if necessary.
70
+
71
+
72
+
73
+
At this stage, you can choose whether to connect your repository now or later.
74
+
75
+
76
+
77
+
If you choose **Connect your repository**, you will be able to either create a new repository based on the template or link it to an existing one. If you prefer to skip this step for now, you can choose **Connect later** and connect your version control later using the CLI or through the settings page.
78
+
79
+
If you opt to connect a repository immediately, you will see the following options:
80
+
81
+
- Select whether to create a new repository or connect to an existing one
82
+
- (Optional) Choose a GitHub organization if you have access to multiple organizations
83
+
- Name your repository if you are creating a new one
84
+
- Decide whether to keep the repository private by ticking the checkbox
85
+
86
+
Additionally, you can define the domain for your site, using the Appwrite Sites domain.
87
+
88
+
After reviewing your configuration, click **Deploy**.
89
+
90
+
91
+
## Monitoring the deployment
92
+
93
+
Once you initiate the deployment, you will be taken to a progress page where you can monitor the build and deployment in real time.
94
+
95
+
The logs will show you the different stages of the build process. Depending on the size of your template and the dependencies involved, this process can take anywhere from a few seconds to a few minutes.
96
+
97
+
98
+
99
+
## Access your site
100
+
101
+
After your site has been successfully deployed, Appwrite will show you a **Congratulations** page.
102
+
103
+
104
+
105
+
## Next step
106
+
107
+
Appwrite provides a few options to help you continue setting up or expanding your project.
108
+
109
+
You can **Add domain**, connecting an existing custom domain you own or registering a new one through the console.
110
+
111
+
You can **Share site**, allowing you to collaborate with your team by sharing access to your project.
112
+
113
+
You can also **Open on mobile**, previewing your live site directly from a mobile or tablet device to ensure everything looks and functions as expected across different screen sizes.
114
+
115
+
## Wrapping up
116
+
And with that, the Starlight template is deployed to Appwrite Sites. You can explore other templates or deploy any other websites you'd like.
0 commit comments