|
@@ -2,9 +2,12 @@
|
|
<b>
|
|
<b>
|
|
<a href="https://www.appflowy.io">AppFlowy.IO</a><br>
|
|
<a href="https://www.appflowy.io">AppFlowy.IO</a><br>
|
|
</b>
|
|
</b>
|
|
- ⭐️ The Open Source Notion Alternative ⭐️ <br>
|
|
|
|
|
|
+ ⭐️ The Open Source Alternative To Notion ⭐️ <br>
|
|
</h1>
|
|
</h1>
|
|
|
|
|
|
|
|
+<p align="center">
|
|
|
|
+You are in charge of your data and customizations.
|
|
|
|
+</p>
|
|
|
|
|
|
<p align="center">
|
|
<p align="center">
|
|
<a href="https://discord.gg/9Q2xaN37tV"><img src="https://img.shields.io/badge/AppFlowy.IO-discord-orange"></a>
|
|
<a href="https://discord.gg/9Q2xaN37tV"><img src="https://img.shields.io/badge/AppFlowy.IO-discord-orange"></a>
|
|
@@ -14,73 +17,16 @@
|
|
|
|
|
|
</p>
|
|
</p>
|
|
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-<p align="center">
|
|
|
|
-You are in charge of your data and customizations.
|
|
|
|
-</p>
|
|
|
|
-
|
|
|
|
-
|
|
|
|
<p align="center">
|
|
<p align="center">
|
|
<a href="http://www.appflowy.io"><b>Website</b></a> •
|
|
<a href="http://www.appflowy.io"><b>Website</b></a> •
|
|
<a href="https://discord.gg/9Q2xaN37tV"><b>Discord</b></a> •
|
|
<a href="https://discord.gg/9Q2xaN37tV"><b>Discord</b></a> •
|
|
<a href="https://twitter.com/appflowy"><b>Twitter</b></a> •
|
|
<a href="https://twitter.com/appflowy"><b>Twitter</b></a> •
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
</p>
|
|
</p>
|
|
|
|
|
|
-<p align="center"><img src="https://github.com/AppFlowy-IO/appflowy/blob/main/doc/imgs/welcome.png" alt="The Open Source Notion Alternative." width="1000px" /></p>
|
|
|
|
-
|
|
|
|
-## Install
|
|
|
|
-
|
|
|
|
-### macOS
|
|
|
|
-
|
|
|
|
-```sh
|
|
|
|
-brew install appflowy
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
-### Windows
|
|
|
|
-
|
|
|
|
-There is currently no Windows installer. However, you can download and install the app from the GitHub Releases section.
|
|
|
|
-1. Go to AppFlowy's [Releases](https://github.com/AppFlowy-IO/appflowy/releases/) page on GitHub.
|
|
|
|
-2. Download the current AppFlowy-Windows.zip file
|
|
|
|
-3. Create a directory in your %userprofile%\documents folder
|
|
|
|
-```shell
|
|
|
|
-md %userprofile%\documents\appflowy
|
|
|
|
-```
|
|
|
|
-4. Change to that directory
|
|
|
|
-```shell
|
|
|
|
-cd %userprofile%\documents\appflowy
|
|
|
|
-```
|
|
|
|
-5. Extract the downloaded zip file into the directory you just created.
|
|
|
|
-6. Run the application :
|
|
|
|
-```shell
|
|
|
|
-./app_flowy.exe
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
-### Linux
|
|
|
|
-
|
|
|
|
-There is currently no Linux installer. However, you can download and install the app from the GitHub Releases section.
|
|
|
|
-1. Go to AppFlowy's [Releases](https://github.com/AppFlowy-IO/appflowy/releases/) page on GitHub.
|
|
|
|
-2. Download the current AppFlowy-Linux.tar.gz file.
|
|
|
|
-3. Create a directory in your /opt/ folder.
|
|
|
|
-```shell
|
|
|
|
-mkdir /opt/appflowy
|
|
|
|
-```
|
|
|
|
-4. Change to that directory
|
|
|
|
-```shell
|
|
|
|
-cd /opt/appflowy
|
|
|
|
-```
|
|
|
|
-5. Extract the downloaded compressed file into the directory you just created.
|
|
|
|
-```shell
|
|
|
|
-tar -xvf AppFlowy-Linux.tar.gz
|
|
|
|
-```
|
|
|
|
-6. Run the application :
|
|
|
|
-```shell
|
|
|
|
-./app_flowy
|
|
|
|
-```
|
|
|
|
|
|
+<p align="center"><img src="https://github.com/AppFlowy-IO/appflowy/blob/main/doc/imgs/welcome.png" alt="The Open Source Alternative To Notion." width="1000px" /></p>
|
|
|
|
+
|
|
|
|
+## User Installation
|
|
|
|
+Please view the [documentation](https://appflowy.gitbook.io/docs/essential-documentation/install-appflowy/installation-methods) for OS specific installation instructions.
|
|
|
|
|
|
## Built With
|
|
## Built With
|
|
|
|
|
|
@@ -92,82 +38,8 @@ tar -xvf AppFlowy-Linux.tar.gz
|
|
|
|
|
|
<p align="center"><img src="https://github.com/AppFlowy-IO/appflowy/blob/main/doc/imgs/howtostar.gif" alt="AppFlowy Github" width="1000px" /></p>
|
|
<p align="center"><img src="https://github.com/AppFlowy-IO/appflowy/blob/main/doc/imgs/howtostar.gif" alt="AppFlowy Github" width="1000px" /></p>
|
|
|
|
|
|
-## Getting Started
|
|
|
|
-
|
|
|
|
-### Linux
|
|
|
|
-Please follow these instructions to build on [Linux](doc/BUILD_ON_LINUX.md).
|
|
|
|
-
|
|
|
|
-### Windows
|
|
|
|
-Please follow these instructions to build on [Windows](doc/BUILD_ON_WINDOWS.md).
|
|
|
|
-
|
|
|
|
-### macOS
|
|
|
|
-
|
|
|
|
-How to build on MacOS, please follow these simple steps.
|
|
|
|
-
|
|
|
|
-**Step 1:**
|
|
|
|
-
|
|
|
|
-```shell
|
|
|
|
-git clone https://github.com/AppFlowy-IO/appflowy.git
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
-**Step 2:**
|
|
|
|
-
|
|
|
|
-```shell
|
|
|
|
-cd appflowy/frontend
|
|
|
|
-```
|
|
|
|
-```shell
|
|
|
|
-make install_rust
|
|
|
|
-```
|
|
|
|
-```shell
|
|
|
|
-source $HOME/.cargo/env
|
|
|
|
-```
|
|
|
|
-```shell
|
|
|
|
-make install_cargo_make
|
|
|
|
-```
|
|
|
|
-```shell
|
|
|
|
-cargo make install_targets
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
->
|
|
|
|
->
|
|
|
|
-> 🚀 Skip install_rust or install_cargo_make if you already installed it.
|
|
|
|
-> FYI, AppFlowy uses [https://github.com/sagiegurari/cargo-make](https://github.com/sagiegurari/cargo-make) to construct the build scripts
|
|
|
|
-
|
|
|
|
-**Step 3:**
|
|
|
|
-
|
|
|
|
-Follow the instructions [here](https://flutter.dev/docs/get-started/install) to install Flutter. As AppFlowy uses the `stable` channel, you need to switch the channel. Just type:
|
|
|
|
-
|
|
|
|
-```shell
|
|
|
|
-flutter channel stable
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
-**Step 4:**
|
|
|
|
-* You should enable the specified platform first if you don't enable it before and then select the desktop device.
|
|
|
|
-```shell
|
|
|
|
-# for windows
|
|
|
|
-flutter config --enable-windows-desktop
|
|
|
|
-
|
|
|
|
-# for macos
|
|
|
|
-flutter config --enable-macos-desktop
|
|
|
|
-
|
|
|
|
-# for linux
|
|
|
|
-flutter config --enable-linux-desktop
|
|
|
|
-```
|
|
|
|
-* Open the `app_flowy` folder located at xx/appflowy/frontend with Visual Studio Code or other IDEs at your disposal.
|
|
|
|
-* Run the Generate Language Files command if you don't run it before or you have updated the localization files. Read more at [AppFlowy translation](https://github.com/AppFlowy-IO/docs/blob/main/welcome-to-the-appflowy-wiki/translation.md)
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-* Click the run button.
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-Please also check the device selection, AppFlowy only supports Desktop by now:
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-If you encounter any issues, have a look at [Troubleshooting](https://github.com/AppFlowy-IO/appflowy/wiki/Troubleshooting) first. If your issue is not included in the page, please create an [issue](https://github.com/AppFlowy-IO/appflowy/issues/new/choose) or ask on [Discord](https://discord.gg/9Q2xaN37tV).
|
|
|
|
|
|
+## Getting Started with development
|
|
|
|
+Please view the [documentation](https://appflowy.gitbook.io/docs/essential-documentation/contribute-to-appflowy) for OS specific development instructions
|
|
|
|
|
|
## Roadmap
|
|
## Roadmap
|
|
|
|
|
|
@@ -177,11 +49,11 @@ If you'd like to propose a feature, submit an issue [here](https://github.com/Ap
|
|
|
|
|
|
## **Releases**
|
|
## **Releases**
|
|
|
|
|
|
-Please see the [changelog](https://www.appflowy.io/whatsnew) for more details about a given release.
|
|
|
|
|
|
+Please see the [changelog](https://www.appflowy.io/whatsnew) for more details about a given release.
|
|
|
|
|
|
## Contributing
|
|
## Contributing
|
|
|
|
|
|
-Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. Please look at [CONTRIBUTING.md](https://github.com/AppFlowy-IO/appflowy/blob/main/doc/CONTRIBUTING.md) for details.
|
|
|
|
|
|
+Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. Please look at [CONTRIBUTING.md](https://github.com/AppFlowy-IO/appflowy/blob/main/doc/CONTRIBUTING.md) for details.
|
|
|
|
|
|
## Why Are We Building This?
|
|
## Why Are We Building This?
|
|
|
|
|
|
@@ -206,10 +78,11 @@ To be honest, we do not claim to outperform Notion in terms of functionality and
|
|
|
|
|
|
## License
|
|
## License
|
|
|
|
|
|
-Distributed under the AGPLv3 License. See `LICENSE.md` for more information.
|
|
|
|
|
|
+Distributed under the AGPLv3 License. See `LICENSE.md` for more information.
|
|
|
|
|
|
## Acknowledgements
|
|
## Acknowledgements
|
|
|
|
|
|
Special thanks to these amazing projects which help power AppFlowy.IO:
|
|
Special thanks to these amazing projects which help power AppFlowy.IO:
|
|
|
|
|
|
- [flutter-quill](https://github.com/singerdmx/flutter-quill)
|
|
- [flutter-quill](https://github.com/singerdmx/flutter-quill)
|
|
|
|
+- [cargo-make](https://github.com/sagiegurari/cargo-make)
|