Low friction setup

Install it on any main device.

The app runs from a local Node server. You open it in your browser at http://127.0.0.1:3000. Supabase is optional for cloud features.

Android first Desktop setup

Android

Termux setup.

Use Termux from F-Droid or GitHub. The old Play Store Termux is outdated and can break installs.

Install

bash <(curl -fsSL https://raw.githubusercontent.com/Suydev/isotope-code/main/install-termux.sh)

Run

isotope start
isotope open

Desktop

Windows, Linux, macOS.

Linux

git clone https://github.com/Suydev/isotope-code.git
cd isotope-code
bash setup.sh
isotope start

macOS

git clone https://github.com/Suydev/isotope-code.git
cd isotope-code
bash setup.sh
isotope start

Windows PowerShell

git clone https://github.com/Suydev/isotope-code.git
cd isotope-code
.\install.ps1
1

After setup

Open the app in the browser:

http://127.0.0.1:3000
2

If it fails

Use doctor and logs before changing files.

isotope doctor
isotope logs
isotope repair

Supabase

Only add cloud when ready.

Local features can run first. Add Supabase URL and anon key when you want login, sync, backup restore, avatars, and groups.

SUPABASE_URL=https://your-project-ref.supabase.co
SUPABASE_ANON_KEY=your-anon-public-key
PORT=3000
ENABLE_ADMIN_MODE=false