# Supertransaction API - LLM Context File

This file provides context about the Supertransaction API project for Large Language Models.

## Project Overview

Supertransaction API is a cutting-edge Web3 API platform that provides gasless, composable DeFi infrastructure for Web3 applications. Built with React, TypeScript, and Express.js, it focuses on solving integrator pain points by reducing user drop-off from gas fees and eliminating complex integration times.

## Key Technologies

- Frontend: React 18 + TypeScript + Vite
- Backend: Express.js with TypeScript
- Database: PostgreSQL (Neon Database)
- UI: Shadcn/ui + Tailwind CSS + Framer Motion
- Deployment: Static files optimized for modern hosting

## Architecture

The application follows a modern full-stack architecture:
- React frontend with Wouter routing and TanStack Query for state management
- Express.js backend with RESTful API design
- PostgreSQL database with Drizzle ORM
- Shared TypeScript schemas for type safety
- Vite build system with production optimization

## Key Features

- Gasless DeFi operations with universal cross-chain compatibility
- Pre-built DeFi flow templates and composable actions
- Native EOA compatibility with traditional and embedded wallets
- Enterprise-grade design system with fintech aesthetics
- Comprehensive SEO optimization and social media integration
- Progressive Web App capabilities with analytics integration

## Project Structure

- `client/` - React frontend application
- `server/` - Express.js backend API
- `shared/` - Shared TypeScript schemas and types
- `dist/` - Production build output (deploy this folder)

## Deployment

The project builds to a `dist` folder containing optimized static files ready for deployment to any hosting platform. The build process includes:
1. Vite frontend compilation
2. ESBuild server bundling  
3. Asset optimization and compression
4. Directory structure optimization for static hosting

## Development Workflow

- `npm run dev` - Start development server
- `npm run build` - Build production files
- `node fix-dist.js` - Fix deployment structure
- `npm run start` - Run production server locally

## Documentation

Complete project documentation is maintained in `replit.md` with architectural decisions, user preferences, and development guidelines.

Generated on: 2025-08-28T15:56:01.927Z