From b21f5606623097db41953a2797deb7cb677bd155 Mon Sep 17 00:00:00 2001 From: khorshuheng Date: Tue, 14 Jan 2025 14:34:45 +0800 Subject: [PATCH] chore: add additional guideline for developer --- .development.env | 3 +++ README.md | 17 +++++++++++++++-- 2 files changed, 18 insertions(+), 2 deletions(-) create mode 100644 .development.env diff --git a/.development.env b/.development.env new file mode 100644 index 0000000..1943513 --- /dev/null +++ b/.development.env @@ -0,0 +1,3 @@ +AF_BASE_URL=http://localhost +AF_GOTRUE_URL=http://localhost/gotrue +AF_WS_URL=ws://localhost/ws/v1 diff --git a/README.md b/README.md index e84546b..9b7579f 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

-Bring projects, wikis, and teams together with AI +Bring projects, wikis, and teams together with AI

Web • @@ -29,7 +29,7 @@ Bring projects, wikis, and teams together with AI - Create and publish documentation for your customers and audience - Write, publish, and manage content with AI - Manage tasks and projects for yourself and your team - + ## Features - Write beautiful documents with rich content types - Add a Quick Note to jot down lists, ideas, or to-dos @@ -62,6 +62,19 @@ Join our Discord server to get help! ![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white) ## Development +### Pre-requisite +AppFlowy Cloud must be running and accessible by AppFlowy Web. If you alredy have AppFlowy Cloud running, you can skip this step. + +For local development, please follow the steps below: +1. Install [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) +2. Clone the AppFlowy Cloud repository. +3. Copy deploy.env to .env, then run `docker-compose up -d`. +4. The AppFlowy Cloud API should be running on localhost:80, and allow CORS from localhost:3000 by default. +5. Setup at least one sign in method: SMTP for magic link, or using an OAuth provider. Refer to AppFlowy Cloud repository for more details. + +### Running AppFlowy Web Locally +1. Copy .development.env to .env. The default value assumes that AppFlowy Cloud is deployed on localhost. If not, please update the value of the API endpoints. +2. Make sure `npm` has been installed on your dev environment, then run the following: ``` # npm install pnpm@8.5.0 pnpm install