Qyou is an open-source, crowd-powered queuing intelligence platform that helps people avoid long lines at real-world locations like banks, hospitals, fuel stations, government offices, and service centers.
By allowing users to report and view real-time wait times, QueueWise turns everyday queuing into shared public data. Built on Stellar, the platform adds a lightweight trust, rewards, and incentives layer—encouraging honest reporting and enabling new queue-based micro-economies.
Queues waste time, energy, and productivity—especially in high-traffic public services. Yet queue information is usually invisible until you arrive.
QueueWise makes wait times visible before you commit.
With QueueWise, users can:
- Check real-time queue conditions before leaving home
- Decide the best time to visit a location
- Earn rewards for contributing accurate queue data
- Hire or become a queue buddy—someone who holds a spot in line on your behalf
By combining crowd-sourced data with blockchain-backed incentives, QueueWise creates a system where truthful reporting is rewarded and time is treated as a valuable resource.
- Real-Time Queue Reporting – Users submit live wait-time updates at locations
- Crowd Verification – Multiple reports improve accuracy and confidence
- Queue Discovery – View nearby locations and their current wait times
- Queue Buddies – Hire trusted users to hold a spot in line for you
- Stellar-Powered Rewards – Earn tokens for verified reports and services
- Reputation & Trust – On-chain signals back honest contributors
- Mobile-First Experience – Designed for fast, on-the-go reporting
QueueWise is designed as a scalable monorepo with clear separation between user experience, core logic, and blockchain integration.
| Layer | Technology |
|---|---|
| Frontend | React (Web & Mobile-ready) |
| Backend API | Node.js / NestJS |
| Database | MongoDB |
| Blockchain | Stellar |
| Payments & Rewards | Stellar micro-payments & incentives |
| Authentication | Token-based auth |
| Location Services | Maps & geolocation APIs |
The monorepo structure enables rapid iteration while keeping responsibilities isolated:
queuewise/
├── apps/
│ ├── web/ # User-facing web app
│ ├── mobile/ # Mobile app (future-ready)
│ └── api/ # Backend API
├── libs/
│ ├── queues/ # Queue models & aggregation logic
│ ├── reports/ # Wait-time submissions & validation
│ ├── users/ # Profiles, reputation & trust scores
│ ├── rewards/ # Stellar rewards & payouts
│ ├── payments/ # Queue buddy payments
│ └── utils/ # Shared utilities
├── contracts/ # Stellar smart contracts
├── tests/ # Unit & integration tests
├── .env.example
├── package.json
└── README.md
POST /queues/report– Submit a wait-time reportGET /queues/nearby– Discover queues around a locationGET /queues/:id– View aggregated queue details
POST /buddies/request– Hire a queue buddyPOST /buddies/accept– Accept a queue taskGET /buddies/:id– Track queue-holding progress
POST /rewards/claim– Claim earned rewardsGET /rewards/balance– View reward balanceGET /rewards/history– Reward activity log
QueueWise uses Stellar to:
- Distribute micro-rewards for verified reports
- Power queue buddy payments
- Anchor reputation signals and trust scores
Smart contracts are intentionally minimal to keep costs low and interactions fast.
- Node.js ≥ 18
- MongoDB
- Stellar Testnet account
- npm or Yarn
git clone https://github.com/qyoue/qyou.git
cd queuewise
npm install
cp .env.example .envnpm run devnpm testQueueWise is open-source and community-driven. Contributions are welcome across frontend, backend, blockchain, data aggregation, and UX.
- Fork the repository
- Create a branch from
main - Pick an issue or propose a new feature
- Keep PRs focused and well-documented
- Add tests where applicable
- Open a pull request with context and screenshots
For questions, feature discussions, or collaboration:
👉 Telegram: https://t.me/+gRA3CdyekZw3MWM0
MIT License