mirror of https://github.com/toeverything/AFFiNE.git synced 2024-12-18 14:01:44 +03:00

There can be more than Notion and Miro. AFFiNE is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.

affine block-editor collaborative editor knowledge-base miro miro-alternative notion notion-alternative privacy-first rust semantic starred-repo starred-toeverything-repo yjs

Go to file

Whitewater 22f325fbff Merge pull request #166 from toeverything/refactor/page-tree-styles Refactor/page tree styles		2022-08-10 10:38:17 +08:00
.github	chore: temp disable parallel due to cache issues	2022-08-09 10:22:52 +08:00
.husky	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.vscode	feat: binary export	2022-08-10 00:52:50 +08:00
apps	chore: update collasp page styles	2022-08-09 21:25:22 +08:00
docs	refactor(src): change affine to AFFiNE in string	2022-08-01 14:27:26 +08:00
libs	Merge pull request #166 from toeverything/refactor/page-tree-styles	2022-08-10 10:38:17 +08:00
tools	Update notify.mjs	2022-08-09 10:55:02 +08:00
.all-contributorsrc	feat(all-contributorsrc): update project name	2022-08-03 18:37:39 +08:00
.cz-config.js	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.editorconfig	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.env	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.eslintignore	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.eslintrc.json	feat(comming-soon): add comming-soon	2022-07-22 21:38:57 +08:00
.gitignore	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.npmrc	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
.prettierignore	style(formatting): update .prettierignore	2022-08-01 10:59:38 +08:00
.prettierrc	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
babel.config.json	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
jest.config.js	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
jest.preset.js	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
LICENSE	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
nx.json	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
package.json	feat: basic e2e	2022-08-08 02:30:15 +08:00
pnpm-lock.yaml	feat: binary export	2022-08-10 00:52:50 +08:00
pnpm-workspace.yaml	init: the first public commit for AFFiNE	2022-07-22 15:49:21 +08:00
README.md	Update README.md	2022-08-09 15:01:38 +08:00
tsconfig.base.json	feat: enable resolveJsonModule	2022-08-03 00:31:03 +08:00
workspace.json	feat: basic e2e	2022-08-08 02:30:15 +08:00

README.md

AFFiNE.PRO
The Next-Gen Knowledge Base to Replace Notion & Miro.

Planning, Sorting and Creating all Together. Open-source, Privacy-First, and Free to use.

Website • Discord • Twitter • Medium • Telegram

affine_screen

Stay Up-to-Date and Support Us

How to use

If you have experience in front-end development, you may wish to refer to our documentation to learn more about deploying your own version or contributing further to development. For those intersting in trying our latest version, please bear with us as we are planning to launch a web version soon. Also, thanks to Lee who has made a desktop build with Tauri for you to try out. Please notice that AFFiNE is still under Alpha stage and is not ready for production use.

Stay Up-to-Date and Support Us
How to Use
Table of contents
Documentation
- Getting Started with development
Roadmap
Releases
Feature requests
FAQ
The Philosophy of AFFiNE
Community
Contributors
Acknowledgments
License

Shape your page

Plan your task

Sort your knowledge

Create your story

We want your data always to be yours, without any sacrifice to your accessibility. Your data is always stored local first, yet we support real-time collaboration on a peer-to-peer basis. We don't think "privacy-first" is a good excuse for not supporting modern web features. And when it comes to collaboration, these features are not just necessarily for teams -- you can take and insert pictures on your phone, edit them from your desktop, and then share them with your collaborators. Affine is fully built with web technologies to ensure consistency and accessibility on Mac, Windows and Linux. The local file system support will be available when version 0.0.1beta is released.

Documentation

AFFiNE is not yet ready for production use. For installation, you may check how to build or deploy AFFiNE from our quick-start guide. Alternatively, you can view our full documentation.

Getting Started with development

Please view the path Contribute-to-AFFiNE/Software-Contributions/Quick-Start in the documentation.

Roadmap

Coming Soon...

Releases

Get our latest release notes from here.

Feature requests

Please go to feature requests.

FAQ

Get quick help on Telegram or Discord and join our community of developers and contributors.

Our latest news can be found on Twitter, Medium and the AFFiNE Blog.

The Philosophy of AFFiNE

Timothy Berners-Lee once taught us about the idea of the semantic web, where all the data can be interpreted in any form while the "truth" is kept. This gives our best image of an ideal knowledge base by far, that sorting of information, planning of project and goals as well as creating of knowledge can be all together. We have witnessed waves of paradigm shift so many times. At first, everything was noted on office-like apps or DSL like LaTeX, then we found todo-list apps and WYSIWYG markdown editors better for writing and planning. Finally, here comes Notion and Miro, who take advantage of the idea of blocks to further liberate our creativity. It is all perfect... without waste operations and redundant information. And, we insist that privacy first should always be given by default. That's why we are making AFFiNE. Some of the most important features are:

Transformable
- Every block can be transformed equally
  - e.g. you can create a todo in Markdown in the text view and then later edit it in the kanban view.
- Every document can be turned into a whiteboard
  - An always good-to-read, structured docs-form page is the best for your notes, but a boundless doodle surface is better for collaboration and creativity.
Atomic
- The basic elements of AFFiNE are blocks, not pages.
  - Blocks can be directly reused and synced between pages.
- Pages and blocks are searched and organized based on connected graphs, not tree-like paths.
- Dual-link and semantic search are fully supported.
Collaborative and privacy-first
- Data is always stored locally by default
- CRDTs are applied so that peer-to-peer collaboration is possible.

We appreciate the ideas of Monday, Airtable, and Notion databases. They have inspired us and shaped our product, helping us get it right when it comes to task management. But we also do things differently. We don't like doing things again and again. It's easy to set a todo with Markdown, but then why do you need to repeat and recreate data for a kanban or other databases. This is the power of AFFiNE. With AFFiNE, every block group has infinite views, for you to keep your single source of data, a signle source of truth.

We would like to give special thanks to the innovators and pioneers who greatly inspired us:

Quip & Notion -- that docs can be organized as blocks
Taskade & Monday -- brilliant multi-dimensional tables
Height & Linear -- beautiful task management tool

We would also like to give thanks to open-source projects that make affine possible:

Yjs & Yrs -- Fundamental support of CRDTs for our implementation on state management and data sync.
React -- View layer support and web GUI framework.
Rust -- High performance language that extends the ability and availability of our real-time backend, JWST.
Fossil -- Source code management tool made with CRDTs which inspired our design on block data structure.
slatejs -- Customizable rich-text editor.
Jotai -- Minimal state management tool for frontend.
Tldraw -- Excellent drawing board.
MUI -- Our most used graphic UI component library.
Other dependencies

Thanks a lot to the community for providing such powerful and simple libraries, so that we can focus more on the implementation of the product logic, and we hope that in the future our projects will also provide a more easy-to-use knowledge base for everyone.

Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

Discuss AFFiNE on GitHub

Contributors

_DarkSky 💻 📖	_{Chi Zhang} 💻 📖	_{wang xinglong} 💻 📖	_DiamondThree 💻 📖	_Whitewater 💻 📖	_{xiaodong zuo} 💻 📖	_{MingLIang Wang} 💻 📖
_Qi 💻 📖	_mitsuhatu 💻 📖	_Austaras 💻 📖	_{Jin Yao} 💻 📖