Skip to content

Commit eb19d3f

Browse files
authored
chore: update github repository and readmes (#138)
* chore: update github repository and readmes * small fixes to docs
1 parent f52b8c7 commit eb19d3f

File tree

12 files changed

+92
-46
lines changed

12 files changed

+92
-46
lines changed

.github/workflows/cla.yml.disabled

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ jobs:
1919
PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
2020
with:
2121
path-to-signatures: ".signatures/v1/cla.json"
22-
path-to-document: "https://github.com/YousefED/blocknote/blob/main/CLA.md" # e.g. a CLA or a DCO document
22+
path-to-document: "https://github.com/TypeCellOS/BlockNote/blob/main/CLA.md" # e.g. a CLA or a DCO document
2323
# branch should not be protected
2424
branch: "main"
2525
# allowlist: user1,bot*

CONTRIBUTING.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Contributing
2+
3+
Directory structure:
4+
5+
```
6+
blocknote
7+
├── packages/core - The core of the editor
8+
├── packages/react - The main library for use in React apps
9+
├── examples/editor - Example React app that embeds the editor
10+
├── examples/vanilla - An advanced example if you don't want to use React or want to build your own UI components
11+
└── tests - Playwright end to end tests
12+
```
13+
14+
An introduction into the BlockNote Prosemirror schema can be found in [packages/core/ARCHITECTURE.md](https://github.com/TypeCellOS/BlockNote/blob/main/packages/core/ARCHITECTURE.md).
15+
16+
## Running
17+
18+
To run the project, open the command line in the project's root directory and enter the following commands:
19+
20+
# Install all required npm modules for lerna, and bootstrap lerna packages
21+
npm install
22+
npm run bootstrap
23+
24+
# Start the example project
25+
npm start
26+
27+
## Adding packages
28+
29+
- Add the dependency to the relevant `package.json` file (packages/xxx/package.json)
30+
- run `npm run install-new-packages`
31+
- Double check `package-lock.json` to make sure only the relevant packages have been affected

README.md

Lines changed: 42 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,27 @@
1-
# BlockNote
2-
1+
<p align="center">
2+
<a href="https://www.blocknotejs.org">
3+
<img alt="TypeCell" src="https://github.com/TypeCellOS/BlockNote/raw/main/packages/website/docs/public/img/logos/banner.svg?raw=true" width="300" />
4+
</a>
5+
</p>
6+
7+
<p align="center">
8+
Welcome to BlockNote! The open source Block-Based
9+
rich text editor. Easily add a modern text editing experience to your app.
10+
</p>
11+
12+
<p align="center">
313
<a href="https://discord.gg/Qc2QTTH5dF"><img alt="Discord" src="https://img.shields.io/badge/Chat on discord%20-%237289DA.svg?&style=for-the-badge&logo=discord&logoColor=white"/></a> <a href="https://matrix.to/#/#typecell-space:matrix.org"><img alt="Matrix" src="https://img.shields.io/badge/Chat on matrix%20-%23000.svg?&style=for-the-badge&logo=matrix&logoColor=white"/></a>
4-
5-
[![npm version](https://badge.fury.io/js/%40blocknote%2Freact.svg)](https://badge.fury.io/js/%40blocknote%2Freact)
6-
7-
**Welcome to BlockNote editor: a "Notion-style" block-based extensible text editor built on top of [Prosemirror](https://prosemirror.net/) and [Tiptap](https://tiptap.dev/).**
14+
</p>
15+
16+
<p align="center">
17+
<a href="https://www.blocknotejs.org">
18+
Homepage
19+
</a> - <a href="https://www.blocknotejs.org/docs/introduction">
20+
Introduction
21+
</a> - <a href="https://www.blocknotejs.org/docs/quickstart">
22+
Documentation
23+
</a>
24+
</p>
825

926
# Live demo
1027

@@ -14,13 +31,15 @@ Play with the editor @ [https://blocknote-main.vercel.app/](https://blocknote-ma
1431

1532
# Example code (React)
1633

34+
[![npm version](https://badge.fury.io/js/%40blocknote%2Freact.svg)](https://badge.fury.io/js/%40blocknote%2Freact)
35+
1736
```typescript
1837
import { BlockNoteView, useBlockNote } from "@blocknote/react";
1938
import "@blocknote/core/style.css";
2039

2140
function App() {
2241
const editor = useBlockNote({
23-
onUpdate: ({ editor }) => {
42+
onEditorContentChange: (editor) => {
2443
// Log the document to console on every update
2544
console.log(editor.getJSON());
2645
},
@@ -32,41 +51,47 @@ function App() {
3251

3352
`@blocknote/react` comes with a fully styled UI that makes it an instant, polished editor ready to use in your app.
3453

35-
If you prefer to create your own UI components (menus), or don't want to use React, you can use `@blocknote/core` (_advanced_, see `examples/vanilla` for a demo).
54+
If you prefer to create your own UI components (menus), or don't want to use React, you can use `@blocknote/core` (_advanced_, [see docs](https://www.blocknotejs.org/docs/vanilla-js)).
3655

3756
# Features
3857

3958
BlockNote comes with a number of features and components to make it easy to embed a high-quality block-based editor in your app:
4059

4160
### Animations:
4261

43-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/animations.gif?raw=true" width="400" />
62+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/animations.gif?raw=true" width="400" />
4463

4564
### Helpful placeholders:
4665

47-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/placeholders.gif?raw=true" width="400" />
66+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/placeholders.gif?raw=true" width="400" />
4867

4968
### Drag and drop blocks:
5069

51-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/dragdrop.gif?raw=true" width="400" />
70+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/dragdrop.gif?raw=true" width="400" />
5271

5372
### Nesting / indentation with tab and shift+tab:
5473

55-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/nesting.gif?raw=true" width="400" />
74+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/nesting.gif?raw=true" width="400" />
5675

5776
### Slash (/) menu:
5877

59-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/slashmenu.gif?raw=true" width="400" />
78+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/slashmenu.gif?raw=true" width="400" />
6079

6180
### Format menu:
6281

63-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/selectmenu.gif?raw=true" width="400" />
82+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/selectmenu.gif?raw=true" width="400" />
6483

6584
### Real-time collaboration:
6685

67-
<img src="https://github.com/YousefED/BlockNote/blob/readme/.resources/collaboration.gif?raw=true" width="400" />
86+
<img src="https://github.com/TypeCellOS/BlockNote/blob/readme/.resources/collaboration.gif?raw=true" width="400" />
87+
88+
# Feedback 🙋‍♂️🙋‍♀️
89+
90+
We'd love to hear your thoughts and see your experiments, so [come and say hi on Discord](https://discord.gg/Qc2QTTH5dF) or [Matrix](https://matrix.to/#/#typecell-space:matrix.org).
6891

69-
# Contributing
92+
# Contributing 🙌
93+
94+
See [CONTRIBUTING.md](CONTRIBUTING.md) for more info and guidance on how to run the project (TLDR: just use `npm start`).
7095

7196
Directory structure:
7297

@@ -79,24 +104,7 @@ blocknote
79104
└── tests - Playwright end to end tests
80105
```
81106

82-
An introduction into the BlockNote Prosemirror schema can be found in [packages/core/ARCHITECTURE.md](https://github.com/YousefED/BlockNote/blob/main/packages/core/ARCHITECTURE.md).
83-
84-
## Running
85-
86-
To run the project, open the command line in the project's root directory and enter the following commands:
87-
88-
# Install all required npm modules for lerna, and bootstrap lerna packages
89-
npm install
90-
npm run bootstrap
91-
92-
# Start the example project
93-
npm start
94-
95-
## Adding packages
96-
97-
- Add the dependency to the relevant `package.json` file (packages/xxx/package.json)
98-
- run `npm run install-new-packages`
99-
- Double check `package-lock.json` to make sure only the relevant packages have been affected
107+
The codebase is automatically tested using Vitest and Playwright.
100108

101109
# Credits ❤️
102110

packages/core/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@blocknote/core",
3-
"homepage": "https://github.com/yousefed/blocknote",
3+
"homepage": "https://github.com/TypeCellOS/BlockNote",
44
"private": false,
55
"license": "MPL-2.0",
66
"version": "0.4.6-alpha.3",

packages/react/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@blocknote/react",
3-
"homepage": "https://github.com/yousefed/blocknote",
3+
"homepage": "https://github.com/TypeCellOS/BlockNote",
44
"private": false,
55
"license": "MPL-2.0",
66
"version": "0.4.6-alpha.3",

packages/website/docs/.vitepress/config.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ export default defineConfig({
150150
// },
151151
algolia: getAlgoliaConfig(process.env),
152152
socialLinks: [
153-
{ icon: "github", link: "https://github.com/yousefed/blocknote" },
153+
{ icon: "github", link: "https://github.com/TypeCellOS/BlockNote" },
154154
// { icon: "twitter", link: "https://twitter.com/TypeCellOS" },
155155
{
156156
icon: "discord",

packages/website/docs/.vitepress/theme/components/Home.vue

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,10 +49,10 @@ defineProps<{
4949
</p>
5050
<div class="star">
5151
<GithubButton
52-
href="https://github.com/yousefed/blocknote"
52+
href="https://github.com/TypeCellOS/BlockNote"
5353
data-size="large"
5454
data-show-count="true"
55-
aria-label="Star yousefed/blocknote on GitHub"
55+
aria-label="Star TypeCellOS/BlockNote on GitHub"
5656
>Star</GithubButton
5757
>
5858
</div>

packages/website/docs/docs/introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Introduction to BlockNote
22

3-
<div><a href="https://www.npmjs.com/package/@blocknote/core"><img style="display: inline" alt="NPM" src="https://img.shields.io/npm/v/@blocknote/react"></a> <a href="https://github.com/yousefed/blocknote"><img style="display: inline" alt="GitHub Repo stars" src="https://img.shields.io/github/stars/yousefed/blocknote?style=social"></a></div>
3+
<div><a href="https://www.npmjs.com/package/@blocknote/core"><img style="display: inline" alt="NPM" src="https://img.shields.io/npm/v/@blocknote/react"></a> <a href="https://github.com/TypeCellOS/BlockNote"><img style="display: inline" alt="GitHub Repo stars" src="https://img.shields.io/github/stars/TypeCellOS/BlockNote?style=social"></a></div>
44

55
BlockNote is a block-based rich-text editor for [React](https://reactjs.org/), focused on providing a great out-of-the-box experience with minimal setup.
66

@@ -24,7 +24,7 @@ On top of that, it comes with a modern block-based design. This gives documents
2424

2525
## Community
2626

27-
BlockNote is currently in early beta. We'd love your feedback! If you have questions, need help, or want to contribute reach out to the community on [Discord](https://discord.gg/Qc2QTTH5dF) and [GitHub](https://github.com/yousefed/blocknote).
27+
BlockNote is currently in early beta. We'd love your feedback! If you have questions, need help, or want to contribute reach out to the community on [Discord](https://discord.gg/Qc2QTTH5dF) and [GitHub](https://github.com/TypeCellOS/BlockNote).
2828

2929
## Next: Set up BlockNote
3030

packages/website/docs/docs/quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Quickstart
22

3-
<div><a href="https://www.npmjs.com/package/@blocknote/core"><img style="display: inline" alt="NPM" src="https://img.shields.io/npm/v/@blocknote/react"></a> <a href="https://github.com/yousefed/blocknote"><img style="display: inline" alt="GitHub Repo stars" src="https://img.shields.io/github/stars/yousefed/blocknote?style=social"></a></div>
3+
<div><a href="https://www.npmjs.com/package/@blocknote/core"><img style="display: inline" alt="NPM" src="https://img.shields.io/npm/v/@blocknote/react"></a> <a href="https://github.com/TypeCellOS/BlockNote"><img style="display: inline" alt="GitHub Repo stars" src="https://img.shields.io/github/stars/TypeCellOS/BlockNote?style=social"></a></div>
44

55
Getting started with BlockNote is quick and easy. All you need to do is install the package and add the React component to your app!
66

packages/website/docs/docs/vanilla-js.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,4 +53,4 @@ const editor = new BlockNoteEditor({
5353

5454
## Example
5555

56-
For an example of a how to set up your custom UI factories, see the [Vanilla JS example](https://github.com/YousefED/BlockNote/blob/main/examples/vanilla/) in the repository.
56+
For an example of a how to set up your custom UI factories, see the [Vanilla JS example](https://github.com/TypeCellOS/BlockNote/blob/main/examples/vanilla/) in the repository.

0 commit comments

Comments
 (0)