Desktop App Reference
Complete reference for the Oaysus Desktop App. Build and manage your website locally with a full visual environment, then push changes to the cloud with a single click. New here? Start with the Quick Start guide.
Quick Reference
Getting Set Up
Download and install
- 1Go to oaysus.com/download and download the installer for your operating system (macOS or Windows).
- 2Open the installer and follow the prompts. The app installs to your Applications folder on macOS or Program Files on Windows.
- 3Launch Oaysus from your Applications folder or Start menu.
Log in
Oaysus uses magic link authentication. No password required.
- 1On the login screen, enter your email address and click Send Magic Link.
- 2Open the email from Oaysus and click the link inside. The app detects the authentication automatically.
- 3Select the website you want to work on from the website switcher in the top bar. You can switch websites at any time.
Session length
Sessions are valid for 7 days. When your session expires, the app prompts you to log in again. Your local data is never affected by session expiry.
Managing Websites
Working in the Page Builder
Working with Theme Packs
Syncing
The Sync tab (Data in the sidebar) shows the sync status for every entity type: Pages, Components, Assets, Templates, Global Components, and Themes. Each card shows a last-synced timestamp and the local item count.
Sync Down
Pulls the latest data from the Oaysus cloud into your local SQLite database. Use this when another team member has made changes in the dashboard that you want to work with locally.
- Pages pulled reflect the current published state in the cloud.
- Components are always read-only (pull only).
- You can pull individual entity types using the Pull button on each card.
Sync Up
Pushes your local changes to the Oaysus cloud. This replaces the equivalent of oaysus theme push from the old CLI workflow.
- Uploads pages, assets, and theme packs.
- A progress bar shows upload percentage and the current file.
- The Sync Log below the cards records every operation with a timestamp and result.
Sync conflicts
If the cloud has changes that conflict with your local edits, the app shows a conflict dialog. You can choose to keep your local version or accept the cloud version for each conflicting item.
Local Data and Storage
The desktop app stores all project data in a local SQLite database on your machine. Nothing you create or edit in the app is sent to the cloud until you explicitly run Sync Up or publish a page.
Database location
~/Library/Application Support/Oaysus/macOS path. Windows stores data in %APPDATA%\Oaysus\.
PagesPage content, component layout, and prop values. Stored per website.AssetsImages and files uploaded through the Media tab.Site configTypography settings and site-level configuration.Theme packsRegistration paths and build metadata for imported theme packs. Source files stay on disk where you placed them.Export and Import
Use the Data tab's Export feature to save a full backup of your local data as a JSON file. Use Import to restore from a backup or migrate data between machines.
Keyboard Shortcuts
Troubleshooting
The app shows a blank canvas after opening a page
The local dev server may still be starting up. Wait a few seconds and the canvas should load. If the issue persists, check that port 4000 is not in use by another process and restart the app.
Components do not appear in the builder after importing a theme pack
The theme pack build may have failed. Open the Theme Packs page and check for a build error on the card. Click Rebuild to retry. Ensure Node.js is installed and the theme pack folder has a valid package.json.
Sync Up fails with an authentication error
Your session has expired. Go to Settings and log out, then log back in with a new magic link. Your local data is preserved through the re-authentication process.
Page changes are not visible on the live site after publishing
Make sure you saved the page before publishing. The Publish button pushes the last saved version. If you made changes after the last save, save first and then publish again. Edge caches clear within a few seconds of publishing.
The app does not detect the magic link after clicking it in email
The magic link opens a browser tab that hands the token back to the app via a deep link. Make sure the Oaysus app is running when you click the link. If the browser opens but the app does not respond, close the browser tab and click the link again.
I need to reset local data for a website
Navigate to Data in the sidebar and use the Reset Local Data option under the Data Settings tab. This wipes local SQLite data for the current website. Run Sync Down afterward to repopulate from the cloud.