Deedify - Tokenized Land Ownership Platform

A full-stack application for fractional ownership of raw land through blockchain technology, built with Next.js frontend and NestJS backend.

🚀 Quick Start

Prerequisites

• Node.js 18+ and pnpm
• Docker and Docker Compose (optional)
• Phantom Wallet browser extension

1. Environment Setup

Backend (.env)

cd apps/api
cp .env.example .env

Edit .env with your values:

# Database
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/deedify

# Solana
HELIUS_RPC_URL=https://devnet.helius-rpc.com/?api-key=11d1056e-2fdc-43bc-a985-c649236d3af1
ANCHOR_PROVIDER_URL=https://devnet.helius-rpc.com/?api-key=11d1056e-2fdc-43bc-a985-c649236d3af1

# App
JWT_SECRET=your_jwt_secret_change_me
PORT=4000
USE_MOCK_ESCROW=true

Frontend (.env.local)

cd frontend
cp .env.example .env.local

Edit .env.local:

NEXT_PUBLIC_API_BASE_URL=http://localhost:4000
NEXT_PUBLIC_SOLANA_RPC=https://devnet.helius-rpc.com/?api-key=11d1056e-2fdc-43bc-a985-c649236d3af1

2. Database Setup

Option A: Docker (Recommended)

# Start PostgreSQL and Redis
docker-compose -f docker/docker-compose.yml up -d

Option B: Local PostgreSQL

Install PostgreSQL locally and update DATABASE_URL in .env

3. Install Dependencies & Start

# Install dependencies (from root)
pnpm install

# Backend setup
cd apps/api
pnpm prisma migrate dev
pnpm prisma db seed

# Start backend (from apps/api)
pnpm dev

# Start frontend (from frontend)
cd ../../frontend
pnpm dev

4. Access the Application

• Frontend: http://localhost:3000
• Backend API: http://localhost:4000
• API Documentation: http://localhost:4000/docs

🧪 Testing the Integration

1. Register & Login

1. Go to http://localhost:3000
2. Click "Register" and create an account
3. Login with your credentials

2. Connect Phantom Wallet

1. Install Phantom wallet extension
2. Create/import a wallet
3. Click "Connect Wallet" in the app
4. Approve the connection

3. Browse & Purchase Land

1. Go to "Listings" page
2. Click on any property to view details
3. Enter number of shares to purchase
4. Click "Purchase Shares"
5. Complete the mock transaction

4. View Holdings

1. Go to "My Holdings" page
2. See your purchased land shares
3. Track your investment performance

📁 Project Structure

deedify/
├── frontend/                 # Next.js frontend
│   ├── app/                 # App router pages
│   ├── components/          # React components
│   ├── lib/                 # API client & utilities
│   └── types/               # TypeScript types
├── apps/api/                # NestJS backend
│   ├── src/
│   │   ├── auth/           # Authentication
│   │   ├── listings/       # Land listings
│   │   ├── orders/         # Purchase orders
│   │   ├── holdings/       # User holdings
│   │   ├── marketplace/    # Trading
│   │   └── ...
│   └── prisma/             # Database schema & migrations
└── docker/                 # Docker configuration

🔧 API Endpoints

Authentication

• POST /auth/register - Register user
• POST /auth/login - Login user
• GET /auth/profile - Get user profile

Listings

• GET /listings - Get all listings
• GET /listings/public - Get public listings
• GET /listings/:id - Get listing details

Orders

• POST /orders - Create purchase order
• POST /orders/:id/pay - Process payment
• GET /orders - Get user orders

Holdings

• GET /holdings - Get user holdings

🎯 Key Features

✅ Implemented

• User authentication (register/login)
• Phantom wallet integration
• Land listing browsing
• Fractional share purchasing (mock)
• Holdings tracking
• Responsive UI with Tailwind CSS

🚧 Mock Implementation

• Solana transaction processing (USE_MOCK_ESCROW=true)
• Payment processing
• NFT minting

📋 TODO

• Real Solana/Anchor integration
• NFT collection & fractional minting
• Governance voting system
• Revenue distribution
• KYC verification
• Property valuation AI

🔐 Security Notes

• JWT tokens for API authentication
• CORS enabled for localhost:3000
• Input validation with Zod schemas
• SQL injection prevention with Prisma
• Wallet signature verification (TODO)

🐛 Troubleshooting

Database Connection Issues

# Check if PostgreSQL is running
docker ps | grep postgres

# Reset database
cd apps/api
pnpm prisma migrate reset --force
pnpm prisma db seed

Frontend Build Issues

cd frontend
rm -rf .next node_modules
pnpm install
pnpm dev

Wallet Connection Issues

• Ensure Phantom wallet is installed
• Check browser console for errors
• Try refreshing the page

📚 Development

Adding New Features

1. Backend: Add controller, service, repository
2. Frontend: Add pages, components, API calls
3. Update types and validation schemas
4. Test the integration

Database Changes

cd apps/api
pnpm prisma migrate dev --name your_migration_name
pnpm prisma generate

🚀 Deployment

Production Environment Variables

# Backend
NODE_ENV=production
DATABASE_URL=your_production_db_url
JWT_SECRET=your_secure_jwt_secret
USE_MOCK_ESCROW=false

# Frontend
NEXT_PUBLIC_API_BASE_URL=https://your-api-domain.com

Docker Deployment

# Build and run with docker-compose
docker-compose -f docker/docker-compose.prod.yml up -d

📄 API Documentation

• Swagger UI: http://localhost:4000/docs
• Postman Collection: Available in /docs/postman-collection.json
• OpenAPI Spec: Available at /docs/openapi.json

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📞 Support

For issues and questions:

• Check the troubleshooting section
• Review the API documentation
• Create an issue on GitHub

---

Happy coding! 🎉