• User authentication system
• Customizable user profiles
• Follow/unfollow functionality
• Personal avatar system
• Bio and website links

• Create and share posts (tweets)
• Support for text content
• Image upload and preview
• Character limit with counter
• Rich text links detection

• Like/unlike posts
• Comment on posts
• View user profiles
• Real-time character counting
• Expandable comment sections

• Dark/Light mode toggle
• Responsive design
• Modern card-based layout
• Smooth animations
• Clean and intuitive interface

• Node.js 18.0.0 or higher
• npm or yarn
• Git

1. Clone the repository

git clone https://github.com/yourusername/twxt.git
cd twxt

2. Install dependencies

npm install
# or
yarn install

3. Run the development server

npm run dev
# or
yarn dev

4. Open http://localhost:3000 with your browser

• Framework: Next.js 14
• Frontend Library: React 18
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Icons: Lucide Icons
• State Management: React Hooks
• Storage: Local Storage
• Fonts: Geist Font Family

twxt/
├── public/          # Static files
├── src/
│   ├── app/        # Next.js app directory
│   ├── components/ # React components
│   │   ├── auth/   # Authentication components
│   │   ├── layout/ # Layout components
│   │   ├── profile/# Profile components
│   │   ├── tweet/  # Tweet components
│   │   └── ui/     # UI components
│   ├── hooks/      # Custom React hooks
│   ├── lib/        # Utility functions
│   └── types/      # TypeScript types
└── styles/         # Global styles

- Rich text input with character limit
- Image upload with preview
- Client-side URL detection
- Keyboard shortcuts (Cmd/Ctrl + Enter to post)

- Customizable display name
- Bio with character limit
- Location and website fields
- Following/Followers count
- Personal tweet collection

- Like/Unlike animations
- Nested comments
- User mentions
- Profile navigation

• Real-time updates
• Media gallery
• Direct messaging
• Hashtag system
• Search functionality
• Bookmarks
• Analytics
• Mobile app

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

This project is licensed under the MIT License - see the LICENSE file for details.

• Next.js
• React
• Tailwind CSS
• shadcn/ui
• Lucide Icons

If you need help with the application, feel free to:

• Open an issue on GitHub
• Send a pull request
• Contact the developer