ModernDeck is an app/extension running atop TweetDeck that brings a new, Material Design-inspired interface, as well as new customization features.
ModernDeck is designed by dangeredwolf and released under the MIT License.
To build ModernDeck, you need to first install Node.js (which comes with npm) and git if you don't have it installed already
ℹ ModernDeck is tested against the Node 16. It will probably work fine on Node 12+
For Windows, you can download Node.js here
⚠ On Windows, you will need to download git if you haven't yet already. You can either download just git itself, or download GitHub's Windows client, which also includes git and other tools, even if you don't use the GUI portion.
For macOS, you can install the necessary packages using Homebrew.
brew install git node
ℹ Xcode Command Line Tools also include git. If you already have it, you can remove "git" from the command.
❓ Alternatively, you can also install nodejs using the .pkg installer
On Linux, it varies depending on your distribution. If you're using Ubuntu or Debian, you just need to run:
sudo apt install git nodejs
You'll want to use your Terminal (macOS and Linux) or PowerShell (Windows) for this.
First, of course, cd into a directory where you want to clone the source to.
Next, clone the git.
git clone https://github.com/dangeredwolf/ModernDeck.git
Finally, install all the necessary NPM dependencies
npm install
ℹ This may take several minutes
From the main folder where you just were, you can run the app for testing using:
npm start
This will run rollup and create an electron instance for it.
ℹ Building ModernDeck's source with Rollup increments the Build number as well
To start without building...
npm run startNoBuild
To update language data (DataI18n) from tweetdeck-i18n.csv...
npm run updatei18n
If you want to create the proper installers, you can run:
npm run build
...to build for every platform your OS supports building for
npm run buildWindows
...to build for Windows
npm run buildMac
...to build for macOS
npm run buildLinux
...to build for Linux
Click here for more information about electron-builder*
ModernDeck also includes build.bat for Windows.
It requires Windows 10 or Windows Server 2019, with WSL installed (including wsl.exe), with the proper tools (node, npm) installed on both WSL and Windows.
This makes it very quick to build for every platform, including extension, except macOS, particularly because it doesn't require the electron build server.
⚠ Building for macOS requires running under macOS. Under macOS, you can build for Windows, macOS, and Linux. Under both Linux and Windows, you can build for both Linux and Windows. (Windows requires WSL, see above)
First, you need to run rollup.
npm run rollup
This will transpile ModernDeck source and dependencies into a single moderndeck.js file. This needs to be run if you make JS changes under the ModernDeck/src directory
ℹ Building ModernDeck's source with Rollup increments the Build number as well
To test the extension, you'll want to load the unpacked extension. This, of course, varies by browser.
Open the Chrome menu, go to More tools > Extensions
Turn on Developer Mode in the top right corner if you haven't already.
Click the Load unpacked button
Navigate to ModernDeck/common and click Select Folder
Go to about:debugging
Click This Firefox
Click Load Temporary Add-on...
Navigate to ModernDeck/common/manifest.json
Open the ... menu
Click Extensions
Turn on Developer Mode in the bottom left corner if you haven't already
Click the Load unpacked button
Navigate to ModernDeck/common and click Select Folder
Microsoft Edge Legacy (The EdgeHTML-based browser) is no longer supported in ModernDeck 8.0 and later. It might still work, but no problems with it will be corrected.
Click the Extensions button in the bar on the left side (the icon looks like a box)
Turn on Developer Mode in the top right if you haven't already
Click Load unpacked
Select ModernDeck/common and click Select Folder
Run npm install && node build/build.js from the root ModernDeck directory. The corresponding ZIPs will appear in the dist folder
Don't hesitate to ask! twitter@dangeredwolf, twitter@ModernDeck, or telegram@dangeredwolf