An open-source Chrome extension designed to help you craft potentially more viral posts for Twitter (X) by providing data-driven suggestions using intelligent analysis.
- Text Analysis: Input your draft post text directly into the extension popup.
- Virality Suggestions: Get intelligent suggestions based on analysis to improve your post's potential reach.
- Simple Interface: Easy-to-use popup for quick text input and viewing results.
- Asynchronous Processing: Uses background processing so your browser remains responsive.
- Local Storage: Temporarily stores text and results locally for efficient operation.
There are three ways to install the extension:
1. From the Chrome Web Store (Recommended)
- Visit the Viral X Post Helper page on the Chrome Web Store.
- Click the "Add to Chrome" button.
2. Loading Unpacked Extension (for latest development version)
If you want the absolute latest code or the extension is temporarily unavailable on the store:
- Download: Download the latest release
.zip
file from the Releases page or clone the repository:git clone https://github.com/YOUR_USERNAME/viral-x-post-chrome-extension.git cd viral-x-post-chrome-extension
- Build: You need Node.js and npm installed. Run the following commands:
This will create a
npm install npm run build
dist
directory containing the built extension files. - Load in Chrome:
- Open Chrome and navigate to
chrome://extensions/
. - Enable "Developer mode" using the toggle switch in the top-right corner.
- Click the "Load unpacked" button.
- Select the
dist
directory created in step 2. - The extension icon should appear in your Chrome toolbar (you might need to pin it).
- Open Chrome and navigate to
3. For Developers
- Clone the Repository:
git clone https://github.com/YOUR_USERNAME/viral-x-post-chrome-extension.git cd viral-x-post-chrome-extension
- Install Dependencies:
npm install
- Environment Variables: This extension communicates with a backend server for its analysis feature. Developers need to configure API credentials to connect to this service.
- Create a file named
.env
in the project root. - Add your Backend Server API key and potentially the API endpoint URL to the
.env
file. Example:BACKEND_API_KEY=your_api_key_here BACKEND_API_URL=your_backend_server_url_here # If not using a default/included one
- (Explain clearly how developers can set up the backend service or obtain the necessary API key and endpoint URL. Link to backend setup documentation if applicable.)
- Create a file named
- Build/Run:
- For a production build:
npm run build
- For development with auto-reloading (using
webpack --watch
or similar):npm run dev
(Verify this command in your package.json)
- For a production build:
- Load in Chrome: Follow step 3 from the "For End-Users" section, selecting the
dist
directory. Changes during development build should reload the extension automatically.
- Click the Viral X Post Helper icon in your Chrome toolbar to open the popup.
- Paste or type the text of your post/tweet into the text area.
- Click the "Enhance Post" (or similar) button.
- The extension will show a processing state.
- Once the analysis is complete, the suggestions or the rewritten text will appear in the popup.
- Copy the suggested text and use it in your Twitter (X) post.
- Frontend: HTML, CSS, JavaScript (Popup)
- Background: TypeScript
- Build Tool: Webpack
- APIs:
- Chrome Extension API (
storage
,runtime
) - Server API - Powers the backend analysis and suggestion engine.
- Chrome Extension API (
- Environment: Node.js
Contributions are welcome! If you'd like to help improve the extension, please follow these steps:
- Fork the repository on GitHub.
- Clone your fork locally (
git clone [email protected]:YOUR_USERNAME/viral-x-post-chrome-extension.git
). - Create a new branch for your feature or bug fix (
git checkout -b feature/your-feature-name
orbugfix/issue-description
). - Make your changes.
- Commit your changes (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin feature/your-feature-name
). - Create a new Pull Request on GitHub.
Please try to follow the existing code style and add comments where necessary.
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 Archit Jain
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Having issues or have questions?
- Open an issue on this GitHub repository.
- Contact the maintainer: [email protected]
Made with ❤️ for better posts!