Platform Architecture

This document provides comprehensive technical documentation for the Built By DAO web platform (app.builtbydao.com).


circle-info

🌐 Platform Overview

πŸ’» Frontend
πŸ–₯️ Backend
πŸ—„οΈ Database
⛓️ Chain

React + Vite

Express.js

PostgreSQL

Base (L2)

circle-info

🎯 Purpose: Unified platform for member onboarding, task management, governance, and rewards

πŸ“Š Scale: 140+ database tables, 87+ API routes, 71 pages


πŸ› οΈ Complete Tech Stack

Frontend

Component
Technology

βš›οΈ Framework

React 18 + TypeScript

πŸ—οΈ Build

Vite

🎨 UI Library

Shadcn/ui (Radix primitives)

🎨 Styling

Tailwind CSS

πŸ“‘ Data Fetching

TanStack Query v5

πŸ”€ Routing

Wouter

✨ Animation

Framer Motion


Backend

Component
Technology

πŸ–₯️ Runtime

Node.js + Express.js

πŸ“ Language

TypeScript

πŸ—„οΈ ORM

Drizzle ORM

βœ… Validation

drizzle-zod

πŸ” Auth

Session-based + OAuth + SIWE

πŸ“¦ Session Store

PostgreSQL (connect-pg-simple)


Database

Component
Technology

πŸ—„οΈ Engine

PostgreSQL (Neon serverless)

πŸ“Š Tables

140+ production tables

πŸ”„ Migrations

Drizzle Kit

πŸ“¦ JSON Support

Full JSONB with GIN indexing


Blockchain

Component
Technology

⛓️ Network

Base (Ethereum L2)

πŸ“š Library

ethers.js

πŸ‘› Wallet

Coinbase OnchainKit + Reown AppKit

πŸ” Auth

Sign-In with Ethereum (SIWE)


circle-check

πŸ“ Key File Locations

Purpose
Path

πŸ—„οΈ Database schema

shared/schema.ts

πŸ”Œ API routes

server/routes.ts

πŸ” Auth

server/auth.ts

🌱 Seed data

server/seed.ts

βš›οΈ App entry

client/src/App.tsx

🧭 Navigation

client/src/components/AppSidebar.tsx

🎨 UI components

client/src/components/ui/

🎨 Design tokens

client/src/index.css


πŸ’»Overviewchevron-rightArchitecturechevron-rightAPI Referencechevron-rightSmart Contractschevron-right

Last updated