Announcement: The Evolution of BlockSuite

[Saul-Mirone]

Dear Community,

We are excited to share some important updates about the future of BlockSuite and AFFiNE.

BlockSuite has been the core editor powering AFFiNE, designed initially as a universal editor framework. Over time, as both BlockSuite and AFFiNE evolved, BlockSuite gradually incorporated more and more of AFFiNE’s specific business logic. While this close integration brought significant enhancements to AFFiNE, it also led BlockSuite away from its original vision as a standalone, universal framework.

To realign with our goals and streamline development, we have made the decision to merge BlockSuite's codebase into AFFiNE. This change allows us to focus on refining the editor specifically for AFFiNE while maintaining its excellent performance and features for our users.

At the same time, we remain committed to the idea of a universal editor framework. Therefore, we will extract and rebuild the core elements of BlockSuite into a new, independent project. This will allow us to return to the original mission of BlockSuite—creating a flexible, universal editor framework that can be used beyond AFFiNE.

What This Means for You

For AFFiNE users: The transition will improve the editor experience within AFFiNE, as we can now tailor BlockSuite's capabilities > to meet the specific needs of AFFiNE users more effectively.

For developers and contributors: The new universal editor project derived from BlockSuite's core will provide an exciting opportunity to collaborate on an open-source editor framework designed for broader use cases.

What’s Next?

We are currently working on integrating BlockSuite into AFFiNE while simultaneously outlining the roadmap for the new universal editor framework. We will keep you updated on both efforts and invite you to contribute your feedback and ideas.

Thank you for being a part of this journey with us. We’re excited about the possibilities this change brings for AFFiNE, BlockSuite, and the community at large.

Stay tuned, and let’s build the future of editing together!

Best regards,
The AFFiNE Team

[medzhidov]

Will you continue support blocksuite as separate project?

[Saul-Mirone]

Will you continue support blocksuite as separate project?

Yes, we plan to move back the infra part once it's stable.

[alterhuman]

Sorry for an update comment, but it's been a month. Any rough ETA on when the new repo (of blocksuite/universal editor framework) will be available?

[Saul-Mirone]

@alterhuman no, it's a long term plan and will take several months.

[goldsam]

So you have a vision of a "universal framework" but not universal enough to support AFFiNE? I have noticed the significant coupling between AFFiNE and BlockSuite since I took an interest in this project, and this announcement unfortunately validates my growing suspicions. Sorry to be a jerk, but you have effectively admitted that creating such a "universal framework" is either too hard or too much of a commitment for you. If it doesn't work for your project, then why would it work for mine?

Although it is expected that a projects' API and structure may evolve significantly prior to a 1.0 release, this is also a major shift in project goals and leadership values. I see this as a glaring red flag that any project with a reliance on BlockSuite is at risk. This is a risk I am unwilling to take.

I wish you the best of luck with AFFiNE.

[Saul-Mirone]

So you have a vision of a "universal framework" but not universal enough to support AFFiNE? I have noticed the significant coupling between AFFiNE and BlockSuite since I took an interest in this project, and this announcement unfortunately validates my growing suspicions. Sorry to be a jerk, but you have effectively admitted that creating such a "universal framework" is either too hard or too much of a commitment for you. If it doesn't work for your project, then why would it work for mine?

Although it is expected that a projects' API and structure may evolve significantly prior to a 1.0 release, this is also a major shift in project goals and leadership values. I see this as a glaring red flag that any project with a reliance on BlockSuite is at risk. This is a risk I am unwilling to take.

I wish you the best of luck with AFFiNE.

Most of your view make sense. I realized from the beginning that there was a significant coupling between this project and Affine, and I made a lot of efforts to decouple it from Affine as much as possible.

But the problem is that for blocksuite, Affine, as its most important user (not the only one for the time being, because we don't have any other income), needs more editor-based features. So the improvement of the architecture and the iteration of new features must be carried out at the same time, which means that putting blocksuite in Affine can achieve our goal at the fastest speed: supporting Affine while improving the architecture of blocksuite as much as possible to a state where it can be used independently.

No one likes breaking change, but it is inevitable for blocksuite, because the project lacked good design and a healthy iteration rhythm at the beginning, which led to the later blocksuite project basically becoming the editor for Affine. An example is that all blocks were only considered to work in Affine at the beginning, and over time, more and more APIs that must be obtained from Affine were added to them.

[catouse]

Anyway, blocksuite is an amazing project, but change is inevitable. It's not late now. Good job!