pnpm check:workspacevalidates root workspace files and package manifests.pnpm buildruns the workspace validation baseline.pnpm lintruns the workspace validation baseline.pnpm typecheckruns the workspace validation baseline.pnpm testruns the workspace validation baseline.
The validation script is intentionally non-blocking for an empty workspace so new apps and packages can be added incrementally without breaking main.
It reintroduces anticipation to digital communication by combining reliable Web2 infrastructure with blockchain-powered payments.
Originally built on Starknet, ourKairos is actively being migrated to the Stellar network to enable faster confirmations, lower transaction costs, and broader accessibility—while preserving a pragmatic hybrid Web2/Web3 architecture.
In a world dominated by instant messages and disposable content, ourKairos is built around intentional delivery.
Capsules are sealed, stored securely, and revealed only when the time is right.
Use cases include:
- Future messages to yourself or others
- Birthday and anniversary surprises
- Scheduled video or audio drops
- Crypto gifts delivered at meaningful moments
The platform is designed to work just as well for casual users as it does for crypto-native users, supporting:
- Guest access
- Registered accounts
- Subscription-powered perks
-
Time-Locked Capsules
Define exactly when a capsule becomes accessible -
Multi-Media Support
Text, images, videos, and crypto gifts -
Hybrid Web2 / Web3 Architecture
- Web2 for storage, integrity, and performance
- Web3 for payments, subscriptions, and ownership
-
Flexible Access
Guest users and authenticated accounts -
Custom Delivery Controls
Recipients, unlock dates, reminders, and visibility -
Secure & Scalable
Built to grow with usage and contributors
ourKairos is built as a modular monorepo using Turborepo, ensuring scalability and clean separation of concerns.
| Layer | Technology |
|---|---|
| Monorepo | Turborepo + pnpm workspaces |
| Frontend | Next.js (App Router) |
| Backend | Express.js + TypeScript |
| Database | MongoDB |
| Blockchain | Stellar (Payments & Time Bounds) |
| Services | Standalone Node.js workers |
ourKairos/
├── apps/
│ ├── web/ # Next.js frontend application
│ ├── api/ # Express.js backend API
│ └── stellar/ # Stellar payment & verification service
│
├── packages/
│ ├── config/ # Shared TSConfig and ESLint rules
│ ├── types/ # Shared TypeScript interfaces
│ └── utils/ # Shared helper functions
│
├── turbo.json # Turborepo pipeline configuration
├── package.json
└── README.md
-
Node.js ≥ 18
-
pnpm
npm install -g pnpm
-
MongoDB (local or Atlas)
-
Clone the repository
git clone https://github.com/your-org/ourKairos.git cd ourKairos -
Install dependencies
pnpm install
-
Configure environment variables
Create a
.envfile inapps/api/:MONGO_URI=mongodb://localhost:27017/ourkairos PORT=3001
Start the full stack (Frontend, API, and Stellar service):
pnpm dev- Frontend: http://localhost:3000
- API: http://localhost:3001
- Stellar Service: Background worker
pnpm buildPOST /capsules— Create a new capsuleGET /capsules/:id— Retrieve capsule detailsPATCH /capsules/:id— Seal or update a capsule
GET /health— API & database health check
ourKairos is fully open-source and welcomes contributors across Web2, Web3, and product engineering.
- Fork the repository
- Create a feature branch from
main - Pick an open issue or propose a new one
- Keep pull requests focused and well-documented
- Always run
pnpm devbefore submitting
- Shared Logic: Place reusable logic in
packages/ - Types: Define all data models in
packages/types - Linting: Run
pnpm lintbefore pushing
The repository includes merge-safe Express observability templates in tooling/express-observability-template.
For questions, design discussions, or pre-PR clarifications:
👉 Telegram: https://t.me/ourKairos
MIT License