Skip to content

tmoreland72/conflux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

Conflux

Conflux is a personal writing/documenting tool, inspired by Atlassian's Confluence. It is a full-stack application using Quasar Framework (Vue.js) for the client and Node.js/Express.js for the server. Both the client and server are built to run in Google Firebase.
Explore the docs »

View Demo · Report Bug · Request Feature

Open Conflux

Table of Contents

About The Project

Conflux is a work in progress. The purpose for starting this project was the desire for a better writing tool at a low/no cost.

Getting Started

What you will need to get started:

  • Quasar Framework

    npm i -g @quasar/cli
  • Firebase account

    • Create a new project
    • Install tools
    npm i -g firebase-tools
  • Algolia account

    • Create a new app
    • Create a new index

Installation

  • Clone the repo

    git clone https://github.com/34fame/conflux
  • Install packages

    cd conflux
    yarn
    
    cd client
    yarn
    cd ..
    
    cd server/functions
    yarn
    cd ../..
  • Copy the environment variables template file and update with your Firebase and Algolia information

    cd client
    cp .quasar.env_template.json .quasar.env.json
  • Initialize the client for Firebase

    cd conflux/client
    firebase init
    
    # Select the Hosting service
  • Initialize the server for Firebase

    cd conflux/server
    firebase init
    
    # Do NOT let the process overwrite `index.js`.
  • Export service account from Firebase as conflux/server/functions/services/firebase/service-account.json

Startup

There are several scripts available in the project, client and server package.json files to assist with starting up Conflux for different scenarios. The easiest is to run everything locally using Firebase emulators.

# From the project root directory
yarn serve:local

If this loads successfully, you should see Conflux open in your browser at http://localhost:8080. You can open the Firebase emulator dashboard at http://localhost:4000. This will give you visibility of the Firest and Cloud Function services now running on your machine.

WARNING: Running locally with emulators means no data will be saved. You will have to deploy your client and server to Firebase and run against that environment for data to remain.

Basic Usage

  • Conflux is a personal documentation workspace. Individuals register with minimal information and authenticate with email and password.

  • Authenticated users can then manage their own books. Inside books are chapters and inside chapters are pages.

  • Page content uses markdown syntax with an embedded editor with VSCode basic capabilities (e.g. search and replace).

  • The Mermaid.js plugin is available to building graphical diagrams in markdown syntax.

Roadmap

See the open issues for a list of proposed features (and known issues).

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. Utilize Conventional Commits when creating commit messages.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'feat: Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Troy Moreland - Graypes#3890 - Discord

Project Link: https://github.com/34fame/conflux

About

Confluence clone using Vue.js and Quasar Framework

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published