Skip to content

PandaBoard is a modern, self-hosted Notion-style workspace. Built with Next.js, NestJS & Lexical. Perfect for personal notes & project management.

Notifications You must be signed in to change notification settings

CyberStackPro/PandaBoard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐼 PandaBoard — Open Source Notion Alternative

PandaBoard is a modern, full-stack, open-source alternative to Notion, built for developers, writers, and teams who want full control over their data and workflows.

It supports workspace organization, nested pages, a rich-text block editor, authentication, and planned real-time collaboration—all powered by cutting-edge web technologies like Next.js, NestJS, Lexical, and PostgreSQL.

Self-host it, customize it, or contribute. PandaBoard is designed to be the fastest way to build your own Notion-style app.

PandaBoard Screenshot


🧾 Table of Contents


📦 Project Structure

.
├── client/     # Next.js frontend with Lexical Editor
├── server/     # NestJS backend with Drizzle + PostgreSQL
└── README.md   # You're here!

Each folder has its own README with setup instructions:


🚀 Features

✅ Finished / ⏳ In progress / 🧠 Planned

  • ✅ Block-based rich text editing (Lexical)
  • ✅ Project/workspace structure
  • ✅ JWT-based authentication
  • ✅ Serverless-ready & scalable architecture
  • ✅ Local storage caching
  • ✅ Responsive layout (mobile/tablet/desktop)
  • ⏳ Real-time collaboration via WebSockets
  • ⏳ Drag and drop reordering
  • ⏳ Markdown export/import
  • ⏳ AI assistant for writing/code blocks
  • 🧠 Role-based access control (RBAC)
  • 🧠 Page history/versioning
  • 🧠 Public sharing + links

🧰 Tech Stack

🖥 Frontend (client/)

🗃 Backend (server/)


🐳 Docker Setup (Coming Soon)

Soon you'll be able to run the entire project with a single command:

docker-compose up --build

Planned containers:

  • client — Next.js frontend
  • server — NestJS backend
  • postgres — PostgreSQL DB
  • Optional: pgAdmin

Want to help? PRs for Docker setup are welcome!


📂 Manual Installation

🔧 Prerequisites

  • Node.js v18+
  • PostgreSQL database
  • pnpm (or npm/yarn)
  • .env files configured (examples provided)

⚙️ Backend Setup (NestJS)

cd server
cp .env.example .env
pnpm install
pnpm run start:dev

This will start the backend server at http://localhost:3333.


🖥 Frontend Setup (Next.js)

cd ../client
cp .env.example .env
pnpm install
pnpm run dev

Frontend runs on http://localhost:3000.

Open in your browser and log in/register to get started.


🤝 Contributing

Your contributions make this project better!

  1. Fork the repo
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -m "Add feature"
  4. Push to the branch: git push origin feature/my-feature
  5. Open a Pull Request

Star ⭐ the project to support it!


📄 License

MIT License — Free for personal and commercial use.

See LICENSE for full license text.


📬 Stay Connected


About

PandaBoard is a modern, self-hosted Notion-style workspace. Built with Next.js, NestJS & Lexical. Perfect for personal notes & project management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published