Skip to content

replit.md

Latest commit

 

History

History
103 lines (82 loc) · 5.24 KB

replit.md

File metadata and controls

103 lines (82 loc) · 5.24 KB

Tetherware.ai - Quantum-Interacting Non-Deterministic AI Framework

Overview

Tetherware.ai presents the quantum-interacting AI paradigm as an open intellectual movement and category-opening concept, not tied to a specific organization. The website explores consciousness-aligned AI systems through true quantum randomness, serving as a research hub, evidence repository, and collaborative inquiry platform. Features include the Inquiry Circle (email-based community signup, auto-subscribes to newsletter), field evidence submissions, research inquiries, and community contributions. The design follows a terminal-aesthetic theme with quantum green accents and professional typography.

User Preferences

Preferred communication style: Simple, everyday language.

System Architecture

Frontend Architecture

Framework & Build System

  • React 18 with TypeScript for type-safe component development
  • Vite as the build tool and dev server for fast development and optimized production builds
  • Client-side routing using Wouter (lightweight alternative to React Router)

UI Layer

  • Component library based on Radix UI primitives with shadcn/ui patterns
  • Tailwind CSS for styling with a custom terminal theme (Matrix-style green-on-black aesthetic)
  • CSS variables for theming, defined in index.css with IBM Plex Mono as the primary monospace font
  • Custom terminal-themed components with "glow" effects and hacker-aesthetic borders
  • Typography convention: All headings use sentence case (only first word capitalized, plus proper nouns)
  • Hero background: Futuristic cityscape image with TETHERWARE branding, darkened with 75% black overlay for text readability

State & Data Management

  • TanStack Query (React Query) for server state management and caching
  • React Hook Form with Zod validation for all form handling
  • Form schemas defined in shared/schema.ts using Drizzle-Zod integration

Routing Structure

  • / - Home page with hero section, Inquiry Circle signup, and newsletter subscription
  • /about - "The Concept" - paradigm origin story and philosophical foundation
  • /products - "Field Evidence" - systems demonstrating quantum AI principles with submission form
  • /research - "Research Agenda" - open research questions with inquiry submission form
  • /people - "People" - originators and contributors to the paradigm
  • /library - "Library" - resources, whitepapers, and downloadable materials
  • 404 handler for undefined routes

Backend Architecture

Server Framework

  • Express.js server with TypeScript
  • Custom Vite middleware integration for development (HMR support)
  • Static file serving in production from dist/public
  • RESTful API endpoints under /api prefix

Data Storage

  • Development: In-memory storage (MemStorage class) with sample data
  • Production-ready: Drizzle ORM configured for PostgreSQL (Neon serverless)
  • Database schema defined in shared/schema.ts with tables for:
    • Users (authentication placeholder)
    • Waitlist submissions (email-only, renamed "Inquiry Circle" in UI, includes source field for tracking signup origin)
    • Product submissions (displayed as "Field Evidence" in UI, with approval workflow)
    • Research submissions (displayed as "Research Inquiries" in UI)
    • Newsletter subscriptions (includes source field for tracking signup origin)
    • Auto-subscription: Inquiry Circle signups automatically add to newsletter table with same source value

API Endpoints

  • POST /api/waitlist - Inquiry Circle registration (displayed as "Join the Inquiry Circle" in UI)
  • POST /api/products - Field evidence submission (displayed as "Share Evidence" in UI)
  • GET /api/products - Fetch approved field evidence examples
  • POST /api/research - Research inquiry submission (displayed as "Propose Inquiry" in UI)
  • POST /api/newsletter - Newsletter subscription
  • POST /api/contact - Contact form submission (inquiry types: Philosophy discussion, Research collaboration, Implementation insights)

Validation & Error Handling

  • Zod schemas for request validation
  • Structured error responses with appropriate HTTP status codes
  • Request/response logging middleware for API routes

External Dependencies

Database

  • Neon Serverless PostgreSQL (via @neondatabase/serverless)
  • Drizzle ORM for database operations and migrations
  • Environment variable DATABASE_URL required for production

Third-Party Services

  • Substack integration for paradigm exploration writings
  • Cloudflare Web Analytics (token placeholder in index.html)
  • Google Fonts (IBM Plex Mono) for terminal aesthetic typography

UI Components & Libraries

  • Radix UI primitives (accordions, dialogs, dropdowns, forms, etc.)
  • shadcn/ui component patterns
  • Lucide React for icons
  • Embla Carousel for potential carousels
  • cmdk for command palette functionality
  • Recharts for potential data visualization

Development Tools

  • Replit-specific plugins (cartographer, dev banner, runtime error overlay)
  • ESBuild for server bundling
  • TypeScript compiler for type checking
  • Drizzle Kit for database migrations

Deployment Target

  • Cloudflare Pages (mentioned in README)
  • Build output: Vite bundles client to dist/public, ESBuild bundles server to dist/index.js
  • Session management infrastructure present (connect-pg-simple) but not actively used