Project info

URL: https://lovable.dev/projects/50feb308-8012-4597-b4cc-3a805f83d9d6

BetweenUs - Community Connection Platform

A modern, responsive social community application built with React, TypeScript, and Tailwind CSS. BetweenUs helps people connect, share experiences, and build meaningful relationships within their communities.

Features

• Onboarding Flow - Smooth user introduction and setup process
• Activity Feed - Share and discover community posts and updates
• People Directory - Browse and connect with community members
• Messaging - Direct communication between users
• Events & Activities - Discover and participate in community events
• Responsive Design - Seamless experience across all devices
• Modern UI - Beautiful, accessible interface built with shadcn/ui

Tech Stack

• Frontend Framework: React 18 with TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Routing: React Router v6
• State Management: TanStack Query
• Icons: Lucide React
• Form Handling: React Hook Form with Zod validation

Project Structure

src/
├── components/          # React components
│   ├── ui/             # Reusable UI components (shadcn/ui)
│   ├── BetweenUsApp.tsx    # Main app component
│   ├── Layout.tsx          # App layout wrapper
│   ├── Navigation.tsx      # Bottom navigation
│   ├── OnboardingFlow.tsx  # User onboarding
│   ├── HomeScreen.tsx      # Home/dashboard
│   ├── FeedScreen.tsx      # Activity feed
│   ├── PeopleScreen.tsx    # People directory
│   ├── MessagesScreen.tsx  # Messaging interface
│   └── EventsScreen.tsx    # Events listing
├── pages/              # Route pages
├── hooks/              # Custom React hooks
├── lib/                # Utility functions
├── assets/             # Images and static assets
└── index.css           # Global styles and design tokens

Design System

The app uses a comprehensive design system with:

• Semantic color tokens (primary, secondary, accent, etc.)
• Custom gradients and shadows
• Responsive typography
• Smooth animations and transitions
• Dark/light mode support (ready for implementation)

Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is built with Lovable and is available for personal use.

Future Enhancements

• User authentication and profiles
• Real-time messaging
• Event RSVP functionality
• Push notifications
• Image uploads and galleries
• Advanced search and filtering

---

Built with ❤️ using Lovable