EuropaTech

Collective real estate investment platform focused on property-level economics, cash-flow visibility, and digital fractional access to premium European properties.

Monorepo layout

Package	Description	Stack
app/	Main web application (SPA + SSR)	React 19, Vite 8, Tailwind 4, TypeScript
api/	REST API + WebSocket server	Express 5, Prisma 7, PostgreSQL, Redis, TypeScript
tg/	Telegram Mini App	React 19, Vite 8, @telegram-apps/sdk
shared/	Shared TypeScript interfaces across packages	TypeScript
contracts/	Solidity smart contracts on Base mainnet	Hardhat 2, OpenZeppelin 5, ethers 6
widget/	Embeddable investment widget	—
packages/sdk-js/	Official JS/TS SDK (@europatech/sdk)	TypeScript, dual ESM/CJS
packages/sdk-python/	Official Python SDK (europatech)	Python ≥ 3.9, httpx

Key features

Investment & Finance

• Property-level reporting with revenue, expense, and cash-flow visibility
• Investor cabinet — portfolio, analytics, tax reports, and distribution history
• Planned peer-to-peer resale path — secondary share trading when enabled, subject to buyer demand and platform rules
• IBAN payout system with admin review
• Partner & referral program (Bronze / Silver / Gold tiers)
• MiCA-aware product controls and annual limit workflows

Blockchain

• EURT (ERC-20) — EUR-pegged token used in supported payment and settlement flows on Base mainnet (0xF0ff21C0a3De78a4503A77340079f3d4dad3d373)
• EuropaShareToken (ERC-1155) — digital property share records
• EuropaYieldVault (ERC-4626), EuropaLending, EuropaBridge (LayerZero)
• SIWE (Sign-In with Ethereum) wallet authentication

Authentication

• Email/password, Google OAuth, Apple Sign-In
• SIWE (wallet), WebAuthn (passkeys)
• Two-factor authentication (TOTP, SMS via Twilio)

Admin Panel

• Full management dashboard — users, KYC (SumSub), payments (Stripe, NOWPayments)
• Audit log, event management, news/blog editor, support tickets
• Built-in IMAP email client

AI

• AI assistant powered by Google Gemini and Anthropic Claude
• RAG-based knowledge base for property analysis
• Document and video analysis via AI SDK (@ai-sdk/google, @anthropic-ai/sdk)

Notifications

• Push (Firebase Cloud Messaging), transactional email (Resend)
• Telegram bot + Mini App, in-app smart notifications
• Weekly digest and drip campaigns

Internationalisation

• 14 UI languages: AR, DE, EN, ES, FR, HI, ID, IT, JA, KO, PT, RU, TR, ZH via i18next

Infrastructure

Service	Provider	URL
Frontend	Hetzner 89.167.108.198 — nginx static	https://europa-tech.org
API	Hetzner 89.167.108.198 — PM2	https://api.europa-tech.org
Telegram Mini App	Hetzner 89.167.108.198 — nginx static	https://tg.europa-tech.org
Widget	Hetzner 89.167.108.198 — nginx static	https://widget.europa-tech.org
Docs	Hetzner 89.167.108.198 — nginx static	https://docs.europa-tech.org
Database	Hetzner local — PostgreSQL (Docker)	—
Cache	Hetzner local — Redis (Docker)	—
Files	Hetzner local files service	https://files.europa-tech.org

Prerequisites

• Node.js >=22
• pnpm 10.34.2 — pinned by packageManager
• PostgreSQL and Redis (local or via Docker)
• (Contracts only) Hardhat — installed as a workspace dev dependency

Development setup

git clone <repo-url>
cd europa-tech
pnpm install

# Copy and fill in env files
cp api/.env.example api/.env

# Apply migrations and seed
pnpm db:migrate
pnpm db:seed

# Start API + frontend in parallel
pnpm dev

Individual targets:

pnpm dev:app    # frontend only  (localhost:5173)
pnpm dev:api    # API only       (localhost:3001)

Common scripts

Command	Description
pnpm dev	Start API + app in parallel (watch mode)
pnpm build	Production build — API + app in parallel
pnpm test	Run all tests (API + app vitest)
pnpm test:api	API unit tests only
pnpm test:app	App unit tests only
pnpm test:e2e	Playwright end-to-end tests
pnpm test:security	API security test suite
pnpm lint	ESLint across all packages
pnpm lint:fix	ESLint with auto-fix
pnpm format	Prettier — write all ts/tsx/js/jsx/json/css/md
pnpm db:migrate	Apply pending Prisma migrations
pnpm db:seed	Seed the database
pnpm db:studio	Open Prisma Studio
pnpm i18n:check	Check i18n key completeness across 13 localized languages
pnpm loadtest:smoke	k6 smoke load test
pnpm loadtest	k6 standard load test
pnpm loadtest:stress	k6 stress load test

Deploy

Production target is Hetzner 89.167.108.198. The script runs local gates (TypeScript, ESLint, Vitest, i18n completeness, frontend build) before pushing and deploying remotely via SSH.

bash scripts/deploy.sh "feat: description of change"

See docs/DEPLOYMENT.md for the full pipeline, environment variable requirements, and rollback procedure.

Smart contracts

cd contracts
pnpm test                                                     # run all tests
pnpm run deploy:sepolia                                      # testnet deploy
pnpm run deploy:mainnet                                      # mainnet deploy

Base mainnet chainId: 8453. All contracts verified on BaseScan.

SDKs

JavaScript / TypeScript (@europatech/sdk)

npm install @europatech/sdk

Python (europatech)

pip install europatech

Documentation

Doc	Path
Architecture	docs/ARCHITECTURE.md
Getting started	docs/GETTING-STARTED.md
Development guide	docs/DEVELOPMENT.md
Testing	docs/TESTING.md
Configuration	docs/CONFIGURATION.md
API reference	docs/API.md
Deployment	docs/DEPLOYMENT.md

License

Proprietary. All rights reserved.