Skip to content

docs-plus/docs.plus

Repository files navigation

📚 docs.plus

Generic badge Apache License PRs Welcome

docs.plus is a free, real-time collaboration tool built on open-source technologies. It empowers communities to share and organize information logically and hierarchically, making teamwork and knowledge sharing straightforward and effective.

🚀 Quick Start

Prerequisites

Ensure you have the following installed:

Development Environment Setup

Follow these steps to set up your development environment:

  1. Clone the Repository

    git clone https://github.com/docs-plus/docs.plus.git
    cd docs.plus
  2. Install Dependencies

    yarn
  3. Build Dependencies

    yarn build
  4. Install Supabase CLI

    brew install supabase/tap/supabase

    If you're using a different package manager, refer to the Supabase CLI installation guide.

Environment Configuration

Before starting the project, you need to create the .env files by following these steps:

  1. Locate the Example Files: You will find .env.example files in the following directories:

    • packages/webapp/.env.example
    • packages/supabase/.env.example
    • packages/hocuspocus.server/.env.example
  2. Create .env Files: Copy each .env.example to a new .env file in the same directory.

    cp packages/webapp/.env.example packages/webapp/.env
    cp packages/supabase/.env.example packages/supabase/.env
    cp packages/hocuspocus.server/.env.example packages/hocuspocus.server/.env
  3. Update Configurations: Edit the .env files to replace placeholders with your actual configuration values.

PostgreSQL Database Setup

You can set up PostgreSQL in your development environment by running the following Docker command:

docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d postgres

For more information on the PostgreSQL Docker image, refer to the official Docker documentation.

Running the Project

After setting up the environment and configuring the .env files, you can start the project in development mode using:

make local

This command will start the development server for the webapp, as well as the backend services (hocuspocus & supabase).

For more details on available commands, refer to the Makefile.

📫 Connect With Us

We'd love to hear from you! You can reach out through the following channels:

📜 License

docs.plus is licensed under the Apache License v2. You are free to use, modify, distribute, and even sell your modifications under the same terms.

🙏 Support Our Project

docs.plus is a free and open-source project. To keep it running and continuously improving, we need your support. If you're able to contribute, we'd greatly appreciate it:

Your support helps maintain our servers and enhances the platform for everyone's benefit. Thank you for your generosity!