|
| 1 | +# Overview |
| 2 | + |
| 3 | +This is a full-stack web application built as an app marketplace or directory. The platform allows users to browse and review applications, while providing administrative capabilities for managing app listings. The application features a public-facing frontend for discovering apps and submitting reviews, alongside an admin dashboard for content management. |
| 4 | + |
| 5 | +# User Preferences |
| 6 | + |
| 7 | +Preferred communication style: Simple, everyday language. |
| 8 | + |
| 9 | +# Recent Changes (Latest First) |
| 10 | + |
| 11 | +## Admin Dashboard Improvements (August 11, 2025) |
| 12 | +- Simplified admin login page to basic card - removed registration form, information section, and security notices |
| 13 | +- Fixed desktop layout for cleaner, more functional admin dashboard |
| 14 | +- Updated "View Public Site" button to open in new tab using target="_blank" |
| 15 | +- Renamed "Marketplace Apps" to "Post-Platforms" throughout admin interface |
| 16 | +- Added pagination system with 10 items per page for better data management |
| 17 | +- Implemented pagination controls with Previous/Next buttons and numbered pages |
| 18 | +- Added pagination info showing current range of displayed items |
| 19 | +- Downloaded W3DS logo locally and recolored from gray to correct MetaState brand purple (#D9B3FF) |
| 20 | +- Removed search functionality from navigation header for cleaner design |
| 21 | +- Reduced hero section and categories padding for more compact layout |
| 22 | +- Updated main description to "MetaState Post-Platforms for sovereign control of your data" |
| 23 | + |
| 24 | +## Admin Interface Rebranding (August 11, 2025) |
| 25 | +- Admin login page completely rebranded with MetaState Foundation styling |
| 26 | +- Login and register buttons updated with lime green styling (HSL 85,100%,85%) |
| 27 | +- Admin dashboard header modernized with bold typography and branded colors |
| 28 | +- Stats cards redesigned with custom rounded containers using MetaState purple and green |
| 29 | +- Replaced shadcn Card components with custom styled div containers |
| 30 | +- Added hover effects and scaling micro-interactions to buttons |
| 31 | +- Fixed JSX syntax errors during rebranding process |
| 32 | +- Maintained functional admin authentication system ( [email protected] / admin123) |
| 33 | + |
| 34 | +# System Architecture |
| 35 | + |
| 36 | +## Frontend Architecture |
| 37 | +- **Framework**: React with TypeScript using Vite as the build tool |
| 38 | +- **Routing**: Wouter for client-side navigation |
| 39 | +- **UI Components**: Radix UI primitives with shadcn/ui component library |
| 40 | +- **Styling**: Tailwind CSS with custom design tokens and CSS variables |
| 41 | +- **State Management**: TanStack Query (React Query) for server state management |
| 42 | +- **Authentication**: Context-based auth provider with session management |
| 43 | + |
| 44 | +## Backend Architecture |
| 45 | +- **Runtime**: Node.js with Express.js framework |
| 46 | +- **Language**: TypeScript with ES modules |
| 47 | +- **Authentication**: Passport.js with local strategy using session-based auth |
| 48 | +- **Password Security**: Built-in crypto module with scrypt for password hashing |
| 49 | +- **Session Storage**: In-memory store for development (MemoryStore) |
| 50 | +- **API Design**: RESTful endpoints with JSON responses |
| 51 | + |
| 52 | +## Database Architecture |
| 53 | +- **Database**: PostgreSQL via Neon serverless |
| 54 | +- **ORM**: Drizzle ORM with connection pooling |
| 55 | +- **Schema Management**: Drizzle migrations with schema definitions in TypeScript |
| 56 | +- **Tables**: Users, apps, and reviews with proper foreign key relationships |
| 57 | +- **Features**: UUID primary keys, automatic timestamps, cascade deletions |
| 58 | + |
| 59 | +## File Storage |
| 60 | +- **Object Storage**: Google Cloud Storage integration |
| 61 | +- **File Uploads**: Uppy file uploader with drag-and-drop interface |
| 62 | +- **Access Control**: Custom ACL system for object permissions |
| 63 | +- **Storage Client**: Google Cloud Storage SDK with external account credentials via Replit sidecar |
| 64 | + |
| 65 | +## Development Environment |
| 66 | +- **Hot Reload**: Vite development server with HMR |
| 67 | +- **Error Handling**: Runtime error overlay for development |
| 68 | +- **Logging**: Custom request/response logging middleware |
| 69 | +- **Build Process**: Vite for frontend bundling, esbuild for server bundling |
| 70 | + |
| 71 | +# External Dependencies |
| 72 | + |
| 73 | +## Core Technologies |
| 74 | +- **React**: Frontend framework with hooks and context API |
| 75 | +- **Express.js**: Web application framework for Node.js |
| 76 | +- **PostgreSQL**: Primary database via Neon serverless platform |
| 77 | +- **Drizzle ORM**: Type-safe database operations and migrations |
| 78 | + |
| 79 | +## Authentication & Security |
| 80 | +- **Passport.js**: Authentication middleware with local strategy |
| 81 | +- **Express Session**: Session management with configurable stores |
| 82 | +- **Node.js Crypto**: Built-in cryptographic functions for password hashing |
| 83 | + |
| 84 | +## File Management |
| 85 | +- **Google Cloud Storage**: Object storage service for file uploads |
| 86 | +- **Uppy**: Modern file uploader with multiple plugins |
| 87 | +- **AWS S3 Plugin**: Uppy plugin for S3-compatible storage uploads |
| 88 | + |
| 89 | +## UI & Styling |
| 90 | +- **Radix UI**: Headless UI primitives for accessibility |
| 91 | +- **Tailwind CSS**: Utility-first CSS framework |
| 92 | +- **Lucide React**: SVG icon library |
| 93 | +- **shadcn/ui**: Pre-built component library |
| 94 | + |
| 95 | +## Development Tools |
| 96 | +- **Vite**: Frontend build tool and development server |
| 97 | +- **TypeScript**: Static type checking for JavaScript |
| 98 | +- **TanStack Query**: Data fetching and caching library |
| 99 | +- **Wouter**: Minimalist routing library for React |
| 100 | + |
| 101 | +## Hosting & Deployment |
| 102 | +- **Replit**: Development and hosting platform |
| 103 | +- **Neon Database**: Serverless PostgreSQL hosting |
| 104 | +- **Google Cloud Platform**: Object storage and authentication services |
0 commit comments