Welcome to the HabitatX codebase! This repository is a monorepo powering the complete HabitatX platform — including the web application, backend services, and blockchain payment infrastructure.
HabitatX is a next-generation housing marketplace built to simplify renting. It helps property owners publish listings and manage tenants while enabling renters to discover trusted spaces, compare real experiences, and handle rent transactions digitally — without relying on traditional agents.
We use pnpm workspaces for dependency management and TurboRepo for fast, scalable builds.
- Monorepo: pnpm workspaces + TurboRepo
- Frontend: React + TailwindCSS
- Backend: Node.js, Express, TypeScript
- Payments Layer: Stellar SDK
- Language: TypeScript (Strict Mode)
Before running the project, make sure you have:
- Node.js (v18+)
- pnpm
corepack enable
# OR
npm install -g pnpmgit clone <your-repo-url>
cd habitatx
# Install dependencies across all apps & packages
pnpm installRun all services together:
pnpm devLocal services:
- Frontend: http://localhost:3000
- API Server: http://localhost:3001
- Payment Service: http://localhost:3002
habitatx/
├── apps/
│ ├── web/ # Client application (Renters & Owners)
│ ├── api/ # Main REST API (Express)
│ └── stellar-service/ # Blockchain payment & transaction handler
│
├── packages/
│ ├── types/ # Shared interfaces, schemas, DTOs
│ ├── config/ # Shared linting & TS configurations
│ └── ui/ # Reusable UI components
│
└── turbo.json # TurboRepo pipeline
Run from the project root:
| Command | What it does |
|---|---|
pnpm dev |
Starts all applications in dev mode |
pnpm build |
Builds all apps and shared packages |
pnpm lint |
Runs lint checks across the monorepo |
pnpm test |
Runs tests (when available) |
pnpm clean |
Clears caches and build artifacts |
Because HabitatX uses a monorepo setup, install dependencies inside the appropriate workspace.
Frontend example
cd apps/web
pnpm add react-queryBackend example
cd apps/api
pnpm add prismaUsing shared workspace packages
cd apps/api
pnpm add "@habitatx/types@workspace:*" -DHabitatX is built around a dual-sided marketplace model.
- Explore available homes, shops, and spaces
- Compare listings using reviews and ratings
- Contact owners directly
- Manage renewals and payments online
- Publish and manage property listings
- Track interest and tenant applications
- Communicate directly with renters
- Receive payments through integrated digital rails
HabitatX focuses heavily on trust signals.
Every property can build a public reputation through:
- Tenant reviews
- Ratings
- Experience feedback
- Owner responsiveness
This helps renters make smarter decisions and encourages higher standards from property owners.
HabitatX integrates with the Stellar ecosystem to support secure, low-friction rent payments and renewals.
Blockchain usage is intentionally focused on payments to keep the user experience simple and practical.
pnpm install
# If problems persist:
rm -rf node_modules
pnpm installBuild outputs and dependencies are intentionally excluded.
If needed:
git rm -r --cached .
git add .
git commit -m "fix: reset git cache"HabitatX is open-source and built for collaboration.
We welcome:
- Feature contributions
- Performance improvements
- UI/UX enhancements
- Documentation updates
- Bug fixes
Contribution basics:
- Fork the repository
- Create a feature branch
- Make focused commits
- Open a Pull Request
Please run:
pnpm lintbefore submitting PRs.
HabitatX aims to redefine how people find and manage spaces — transforming renting into a transparent, community-driven experience where reputation, convenience, and digital payments work together.
Built by developers, for real-world housing challenges.