Troplo
/
Colubrina
mirror of https://github.com/Troplo/Colubrina.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Colubrina - a simple open source chat platform written in Vue, Vuetify, NodeJS, and Socket.io.
152 Commits 1 Branch 31 Tags 3.2 MiB
Vue 52.1%
JavaScript 46.5%
CSS 0.8%
HTML 0.6%
Go to file
Troplo 114674bc70
Merge pull request #16 from ElectricS01/main 
Update vue-cli, ESLint, and Electron
 		2023-12-10 15:38:41 +11:00
.github/workflows update 2022-08-07 14:48:21 +10:00
backend Update deps and embeds 2023-12-10 15:31:02 +11:00
bot 1.0.37 2023-01-30 17:16:38 +11:00
cli Run ESLint and update deps 2023-12-10 14:14:30 +11:00
frontend Update deps and embeds 2023-12-10 15:31:02 +11:00
.gitignore Fix vulnerabilities 2023-06-16 14:21:52 +10:00
.prettierignore init 2022-06-05 22:58:18 +10:00
.prettierrc init 2022-06-05 22:58:18 +10:00
LICENSE add licenses to root 2022-07-29 21:30:17 +10:00
NOTICE add licenses to root 2022-07-29 21:30:17 +10:00
README.md Update README.md 2023-02-11 20:37:30 +11:00
SECURITY.md init 2022-06-05 22:58:18 +10:00
colubrina.service update 2022-07-29 20:34:27 +10:00
nginx.conf update 2022-07-29 21:26:18 +10:00

README.md

Colubrina

Wakatime

You can try a public instance of Colubrina at colubrina.troplo.com.

This is currently beta software, and may not work as expected. Please file an issue if you encounter any.

Colubrina is a simple self-hostable chatting platform written in Vue, and Vuetify for the frontend, and Node.js, Sequelize and Socket.io for the backend.

Checklist

  • Messaging
  • Authentication
  • Admin panel
  • CLI
  • (partially complete) Scroll up to see more messages/jump to searched message
  • User profile cards
  • Group creation and modification
  • Direct message groups
  • Friending
  • Searching
  • Friend nicknames
  • Embeds & MediaProxy
  • Clean-up/refactor code
  • Mobile responsiveness/compatibility
  • Email verification
  • Password resetting
  • Channel message pins
  • Read receipts

Chat Friends Chat with AMOLED theme Chat with profile card and light theme

Backend setup

First, configure a database and user (MariaDB strongly recommended) for Colubrina.
Please navigate to the backend folder and run yarn.

Then navigate to the cli folder, and run the following commands:

yarn

to install dependencies, and then

node .

which should result in an interactive CLI prompt looking like the following:

Troplo/Colubrina CLI
Colubrina version 1.0.1
Failed to check for updates, ensure you are connected to the internet, and services.troplo.com is whitelisted behind any potential firewalls.
? Please select an option (Use arrow keys)
❯ Setup 
  Create user 
  Run migrations 
  Update/create config file 
  Check for updates 
  Build frontend for production 
  Exit

Select setup, and go through the steps.
After completing the initial setup, you may run yarn build in the frontend folder, or select "Build frontend for production" in the CLI.
The backend service can now be started with node . in the backend folder which will run on port 23998.

A systemd service example config file can be found at colubrina.service, and an nginx.conf example.

Frontend setup

Rename .env.example to .env and fill it out with your own information.

yarn install

Compiles and hot-reloads for development

yarn serve

Compiles and minifies for production

yarn build

Lints and fixes files

yarn lint

Customize configuration

See Configuration Reference.

View the Colubrina license in the LICENSE file.