LocalBird is a fully local, mock-Twitter web application built with React and Vite. It allows you to experience a timeline-based social media interface locally, complete with simulated automated 'personas' that interact with the tweets you post!
Live Demo: https://ariesyous.github.io/localbird/
- Premium UI: Features a sleek dark-mode, glassmorphism design crafted with vanilla CSS.
- Local State: All tweets and interactions are managed locally in the browser's state. No external databases or authentication required.
- Simulated Personas: Post a tweet and watch as distinct personas (like the Crypto Bro, the Doomsday Prepper, and the Cat Lady) reply automatically. Their responses react contextually based on the keywords in your tweet!
- Node.js (v18+ recommended)
- npm or yarn
- Clone the repository:
git clone https://github.com/ariesyous/localbird.git
- Navigate into the project directory:
cd localbird - Install the dependencies:
npm install
- Start the development server:
npm run dev
- Open your browser and visit
http://localhost:5173.
- Frontend Framework: React 19
- Build Tool: Vite
- Styling: Vanilla CSS (CSS Variables, Flexbox, CSS Grid)
- Deployment: GitHub Pages
src/components/: Modular React components for the Feed, Sidebar, RightPanel, and individual Tweets.src/services/:personaService.jshandles the logic for scanning tweet text and generating automated replies from our cast of characters.src/store/:TweetContext.jsxprovides the global state for adding tweets and handling "likes".
The project is configured to deploy easily to GitHub Pages. To deploy a new version:
npm run deployMIT