4gaBoards

<div align="center"> <a href="https://4gaboards.com"> <img src="https://github.com/user-attachments/assets/443e9bd8-df6f-4cf3-a8e7-9a79592cb618" alt="4ga Boards"> </a> </br> </br> <div> <img src="https://img.shields.io/github/v/release/RARgames/4gaBoards?color=orange" alt="4ga Boards Latest Release" /> <img src="https://img.shields.io/github/license/rargames/4gaBoards" alt="4ga Boards License" /> <img src="https://img.shields.io/github/contributors/rargames/4gaboards" alt="4ga Boards Contributors" /> </div> <h1>4ga Boards</h1> Straightforward boards system for realtime project management </br> </br> </div>

Features

• Dark Mode
• Intuitive UI/UX
• Advanced Markdown Editor
• Export/Import Boards
• Web App Design - realtime updates without reloading page
• Multitasking Capabilities - simultaneously edit/review cards and filter/rearrange the board, while keeping local description changes
• Google/GitHub/Microsoft/OIDC SSO Login/Register
• Simplistic Wide Screen Design - minimal clutter and no wasted space
• Powerful Shortcuts
• Multiple Language Support (CS, DA, DE, EN, ES, FR, IT, JA, KO, PL, PT, RU, SK, SV, UZ, ZH, UZ)
• Collapsable Lists and Sidebar - saves screen space and allows for easier navigation in complex projects
• Multi-level Hierarchy - projects -> boards -> lists -> cards -> tasks
• Github 2-way sync - Coming soon

More Features

Demo

Try 4ga Boards now!

Documentation

English | Polski

Website

4ga Boards Website

Don't want to get your hands dirty?
Check 4ga Boards Professional Hosting.

Roadmap

4ga Boards Roadmap

Deploy

1. Docker Compose (Recommended)
2. Kubernetes
3. TrueNAS
4. Manual

Docker Compose (Recommended)

Requirements: Docker, Docker Compose

Download docker-compose.yml (or create docker-compose.yml based on the example)

curl -L https://raw.githubusercontent.com/RARgames/4gaBoards/main/docker-compose.yml -o docker-compose.yml

Configure 4ga Boards instance variables

Configure environment sections in docker-compose.yml:

Edit BASE_URL to match your domain name or IP address.
Edit SECRET_KEY with a random value. You can generate it by openssl rand -hex 64.
Edit POSTGRES_PASSWORD and DATABASE_URL replacing notpassword with randomly generated db password.
4ga Boards instance variables

Pull images and start 4ga Boards

docker compose up -d

Default 4ga Boards url: http://localhost:3000
Default user: demo
Default password: demo

Backup and Restore

Before executing backup/restore scripts, change current directory to the directory where docker-compose.yml is located.

Backup 4ga Boards instance data

./boards-backup.sh

Restore 4ga Boards instance data

./boards-restore.sh 4gaBoards-backup.tgz

You can use any relative path.

When restoring, the password has to match docker-compose password (If you don't remember it, you can set new password in docker-compose, but you have to skip altering the default user in backup.tgz/postgres.sql file e.g. comment line ALTER ROLE postgres WITH SUPERUSER INHERIT CREATEROLE CREATEDB LOGIN REPLICATION BYPASSRLS PASSWORD 'XXX' before restoring the backup).

Import from Trello

It's already available in 4ga Boards. Just add a project, then click Import while creating a new board.

Development

Requirements: Node.js
Optional requirements: Docker, Docker Compose

Clone 4ga Boards repository into a directory of your choice

git clone https://github.com/RARgames/4gaBoards.git .

Install dependencies

pnpm i

Copy .env

cp server/.env.sample server/.env

Optional: Build client, copy build to the server directory to suppress startup warnings

pnpm client:build

cp -r client/build server/public

cp client/build/index.html server/views/index.ejs

Start the provided development database (Optionally, use your own database)

docker compose -f docker-compose-dev.yml up -d

If using your own database, edit DATABASE_URL in server/.env.

Initialize the database

pnpm server:db:init

Start the development server

pnpm start

Default 4ga Boards url: http://localhost:3000
Default user: demo
Default password: demo

Web Server Configuration

Web Server Configuration

SSO (Single Sign-On)

SSO

Contributing

Full 4ga Boards Contribution Guidelines

Security

Full 4ga Boards Security Information

Tech Stack

• React, Redux, Redux-Saga, Redux-ORM, react-beautiful-dnd, floating-ui
• Sails.js, Knex.js
• PostgreSQL

License

MIT license

Socials

Main Maintainers