Getting started with AFFiNE and AFFiNE Cloud

Learn how to setup a new workspace and make the most out of the AFFiNE Cloud features.
All posts
Christopher Smolak
Updated: 11/21/2024

Thanks to the cloud functionality AFFiNE can be used for more and more purposes - such as hosting your own blog like us. AFFiNE Blog now uses AFFiNE, more on that next time! For this article, lets go through all the steps of how you can setup a new workspace and make the most out of the AFFINE Cloud features. You can create your own workspace for whatever purpose, with the ability to enable multiplayer and sharing features! So let's dive in.

Start AFFiNE

  • Of course, let's first head over to the AFFiNE App .

xfCNJrPlNxYYLwQ7WcNog2WsTkBlE-k3MIX_xwDNYGs=

You'll be greeted to a screen similar to this. This is the welcome page and it's designed to introduce you to AFFiNE and some of the features on offer. It's a good starting point for new and old users, as it will us be regularly updated to match the latest features and functionality.

Creating a new workspace

Workspaces can be used as a home for your docs. Each workplace can be used to separate your docs and help you better organise your files. Let's create a new workspace, follow these easy steps.

  • Let's go to our workspace list

yWjZotV31ZFBHaQrx_pGqo20vqgzth-hhnHldE_fjTU=

  • Create a new workspace

cgDXT5h-K-CEKfeAJDLjE4e7acaqaJsyIXMlW8XVrCo=

  • Give your workspace a nice name and create it

cfphMKuhJ3J4AVeASvbLGZlMIA1ZNO0-ZhoodeT25k8=

Managing your pages

Our new workspace will be created but we still have the welcome content - so let's make sure we start with a completely empty workspace before getting started.

  • We can head over to the all pages view

UVZZ6dfJvEaiC2dRHH4wA4ChHFe9IxSq8eNP1rl2OMw=

  • And if we click this next to any of our pages we can access various options. Let's delete the default welcome page

Oh0y5KvkBSNHOKNqgyRYd0ulIdoCJgTsThc-SGGW1fM=

  • Let's confirm deletion

h6MqKNBBKnB8YOcHGgocsaO6LmOWGWuGvPQfQ43zhFA=

  • Docs are first sent to trash, so let's take a look over there/image

zxgNAtDgTFtZMfYv8euWduzIZduFzdPMrTKCf-Weero=

  • From our trash screen we can choose to restore this doc or permanenetly delete it, in our case lets delete it

KjOEFNf6vcX_R6ChmZXW5PWoNHgeu-MWrEDffU3I8Yw=

  • And again, just to make sure we confirm you are sure you want to delete this file

VHBhZNNQkxS9muEIZaJ8IMb9daD9B5KeR_5vvxJeh74=

Creating new pages

Now we have a nice, new, clean and empty workspace let's start by creating our content.

  • Let's begin with a new page

1Fm6m1AAga4y9SKz3BDEWgbU_vBVKsnqrIDIO08RS4A=

  • You can give your doc a title and write out any content

D-2VQ3Gag1KLhFx1Dc4EjPE6h64NliNVTHshnlbzCQo=

Workspace Settings

The workplace settings section is a key area for managing your workplace, here you can find many different options.

General

In the general settings we can find some useful options and we can perform various tasks. We can:

  • Change the workspace picture

BGDJWDMwxDo27i6fsujWHleIghBZQLEXj7_bobobzDM=

  • Edit the name of the workspace

W1_2APOrgHu3KdQvPXb5x0RiB3FSyIt-txSyaHZGn0c=

  • Or even delete the workspace

9USzgbhD-z0I0v0LdDVryULKat4Lx0nrQwlJ43hrArY=

  • Currently we are using a local workspace

DwTHUGMGoTE9jyO7_zAgu99IrfSQrCzYsxng3-Z83Ks=

For some features there's no easy way to provide a local-first experience so we also offer AFFiNE Cloud. This setting will allow you to see whether your workspace is local-only or AFFiNE Cloud has been enabled.

AFFiNE Cloud

For some features there's no easy way to provide a local-first experience so we also offer AFFiNE Cloud. By enabling AFFiNE cloud your files stay in sync online and you can easily access them by logging into your account on any device. There are also lots more features that become available to you, let's explore them after activating AFFiNE Cloud.

Activating AFFiNE Cloud

  • If you head over to any of the other tabs, such as Publish, you will find the option to enable AFFiNE Cloud

HCqKxgpOAmR7JnZRQIush0W_lBfKYlo72LZkhJ80ZF4=

  • You may need to login first, if you haven't already.

uvNcIElLqQvAoVXnEUnxArT9c7XNw8TF5-Giu7EnI7g=

  • You will be asked to provide a Google account. Currently Google login is the only supported login method, but more options are coming soon.

Oa2omJIn2bbgSSmiR-kD7gsQ9xIX9N478TXE9oTt5ls=

  • On the Google login screen you can select what account you want to use for your AFFiNE Cloud account

EfpMLloSoRoJL7OCDK-s2jfSC9xeklJKXlg5fHxlPHE=

  • Now in the workspace settings we can see from the general tab that we now have a cloud workspace

tA4B5H9EqFD8A5_cgZ1-1HeEt1xRigye93j2FZ2Ehus=

Sync

There are currently no options here, but as part of upgrading to AFFiNE Cloud your workspace will be kept in sync and linked to your account. This allows you to login and access your content from any device.

Mqv2rwDUf0R5ASKPdjSKS97ruKuzIU4dj-6DDUg3alM=

Collaboration

Let's enable multiplayer. With this we can collaborate real-time with other users within our workspace. Once invited they will have read and write access to the workspace, that includes the ability to delete docs. We'll be adding more permission settings in the future.

  • In the collaboration tab let's invite a new member

Mqv2rwDUf0R5ASKPdjSKS97ruKuzIU4dj-6DDUg3alM=

  • Let's enter our invitees email. Similar to the reason mentioned earlier, currently only gmail accounts are supported. So we only accept @gmail.comaddresses

z6pEfStIogKulFPLM6AnvoOSfoyWww_6Kb-1OQzhmAk=

  • Then we can invite them

DfsnatHQZDqzvwRsyFCWDvowZq3VGOmx5eb8zk6KuPA=

  • Based on your version of AFFiNE you may need to refresh the page first and head back over to the collaboration tab

Z7JU0Xg23P8l_V3jfraDxCWNy_49tlY3b6DioppTD1Y=

  • You should find that the new member has been invited to the workspace
  • They'll show as Pending until the user accepts their invite (sent to their email)
  • If for any reason you need to remove a member just head over to the and remove them from the workspace⋮

W9k-L3gTwwZkKD0Ih5TMcqPBxhHxHY7RrNMxHhZd1mA=

  • Inviting users gives them read and write permissions. If you only want them to be able to view the workspace you can use the publish method.

Publish

In the publish section we can make our workspace available online. So you can then freely share this public link and allow others to view the content you have create - don't worry they won't be able to edit anything, it provides a readonly mode.

  • Let's head to the Publish section, and publish our workspace

7bmH_wyre_TfTPZgcjTxyJ3Yei22CTi_hab9q9OkW4E=

  • Now we have our unique public URL to access our blog, we can copy this link and check it out

DvuS6by758_e9oYQEoS97R4rscgc8THqu79QIYizLns=

Looking for more?

We hope you found this article useful in making the most out of some AFFiNE's cloud features. If there are some steps you think are missing or more features you are trying to make the most of do let us know. You can join our various communities to get more support and we look forward to continually building our documentation and improving the user experience. Do let us know what topic we should cover next!