68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
# 🌌 Plexus
|
|
|
|
Plexus is a **Club 2.0** platform—a hybrid between a live chat and a social network, powered by a simulated **Web3 economy**. It features a "cozy" atmosphere with background music, decentralized-inspired identity, and salon-based communities.
|
|
|
|
|
|
|
|
## 🚀 Key Features
|
|
|
|
- **💎 Club 2.0 Experience**: A cozy digital salon with background music and shared vibes.
|
|
- **🪙 Web3 Economy**: Simulated $PLEXUS token. **1 Message = 1 $PLEXUS**.
|
|
- **🆔 Identity**: Phantom Wallet login and NFT profile pictures.
|
|
- **📱 Mobile Ready**: Fully responsive layout with adaptive components.
|
|
- **⚡ Real-time Social**: Instant messaging, reactions, and user profiles with social walls.
|
|
- **🚦 Transaction Lifecycle**: Simulated blockchain transaction states (Pending, Validated, Failed).
|
|
|
|
## 🛠 Tech Stack
|
|
|
|
- **Frontend**: Vue 3, Pinia, Tailwind CSS, Lucide Icons.
|
|
- **Backend**: Node.js, Express, Socket.io.
|
|
- **Database**: DuckDB (Fast, analytical, and serverless-friendly).
|
|
- **Automation**: Makefile, Husky, Lint-staged, Ruff (Python), ESLint (JS).
|
|
|
|
## 📖 Documentation
|
|
|
|
Explore our detailed documentation in the `docs/` directory:
|
|
|
|
- [🏗 Architecture](file:///home/sinan/Documents/repositories/local/plexus/docs/architecture.md) - High-level system design.
|
|
- [📂 Structure](file:///home/sinan/Documents/repositories/local/plexus/docs/structure.md) - Directory and file organization.
|
|
- [⚙️ Functions & API](file:///home/sinan/Documents/repositories/local/plexus/docs/functions.md) - Socket events and backend logic.
|
|
- [📊 Data Model](file:///home/sinan/Documents/repositories/local/plexus/docs/data-model.md) - Database schema and migrations.
|
|
- [📈 Scalability](file:///home/sinan/Documents/repositories/local/plexus/docs/scalability.md) - Future roadmap and scaling strategies.
|
|
- [📝 Task Tracker](file:///home/sinan/Documents/repositories/local/plexus/docs/tasks.md) - How to use the internal task management tool.
|
|
|
|
## 🚦 Quick Start
|
|
|
|
### Prerequisites
|
|
- Node.js (v18+)
|
|
- Python 3.10+
|
|
- Docker (optional, for dev shell)
|
|
|
|
### Installation
|
|
```bash
|
|
make install
|
|
```
|
|
|
|
### Development
|
|
```bash
|
|
# Start the dev environment (Docker)
|
|
make dev
|
|
|
|
# Or run locally
|
|
cd server && npm run dev
|
|
cd client && npm run dev
|
|
```
|
|
|
|
## 🤝 Contributing
|
|
|
|
We follow a strict development workflow. Please read [CONTRIBUTING.md](file:///home/sinan/Documents/repositories/local/plexus/CONTRIBUTING.md) before starting.
|
|
|
|
1. **Pick a Task**: Use `make task-list` to find something to work on.
|
|
2. **Code**: Implement your changes.
|
|
3. **Verify**: Run `make lint test` to ensure quality.
|
|
4. **Commit**: Pre-commit hooks will automatically run linting and tests.
|
|
5. **Document**: Update relevant docs if you add new features.
|
|
|
|
---
|
|
Built with ❤️ by the Plexus Team.
|