Overwolf

Overwolf

  • Getting Started
  • Docs
  • API
  • Events Status
  • Blog
  • Q&A
  • Support

›Sample App

Getting Started

  • Getting started
  • App Creation process
  • Submit app proposal
  • SDK Introduction
  • Using our dev tools
  • Game compliance principles

Sample App

  • The Basics
  • Components
  • UI components
  • Architecture

Test Your App

  • App testing basics
  • Technical checklist
  • Product checklist
  • Marketing checklist
  • Community alphas

Submit Your App

  • App submission basics
  • Custom Installer
  • App Knowledge base

Monetize with Ads

  • Monetization overview
  • Ads Monetization Basics
  • Ads SDK overview
  • Configuring your Ads
  • Managing Ads
  • Current Ads SDK

Monetize with Subs

  • Subscriptions overview
  • Subscriptions user flow
  • Integrate subscriptions
  • Request an app plan

Maintain Your App

  • Submit an app update
  • Set app status
Edit

Sample app components

You can download the latest version from our GitHub here, and read how to setup it here.

You will find several files and folders in the sample app repository:

  +---- css
  +---- img
  +---- windows
  +---- icons
  +---- odk-ts
  +---- types
  +---- manifest.json
  +---- consts.ts
  +---- package.json
  +---- tsconfig.json
  +---- webpack.config.js

manifest.json

The manifest file is responsible for describing the different aspects of your app. This is a mandatory file for all apps and has to be present in the root folder for your app to function.

In our manifest.json file, we have {start_window:background} defined.
This sets our background window as the app's starting point.

All of this app's windows' properties can be found under the windows object.

windows

Each app window is based on an HTML file. This folder contains these files for each of your pages.

windows/background

The background folder holds the background window, which serves as the application's starting point and window orchestrator.
The window's run() method detects whether a Fortnite game is currently running, decides which window to launch accordingly, and listens for changes.

The background window has no visual representation, which can be gleaned from the empty background.html file or from the {is_background_page:true} property the background window has in our manifest.json.

windows/in_game

The in_game window listens to Info Events and Game Events emitted by the game and displays an ad. Furthermore, it defines the behavior for the show/hide hotkey.

Read all about hotkeys here.

windows/desktop

This window serves a purely visual purpose and has no special logic.

windows/AppWindow

This is a base class that holds the logic shared by the in_game and desktop windows, such as minimize/close, drag, etc.

odk-ts and types

Currently, the Overwolf SDK is written in javascript. These folders hold typescript wrappers and type definitions for the SDK methods used in this app.

We are constantly working on improving our SDK and both the odk-ts and the types definition file will be released as proper packages in the future.

icons

Mandatory files showing up in the Overwolf dock and other locations:
Tile.jpg, IconMouseNormal.png, IconMouseOver.png, desktop-icon.ico.

css and images

All of the visual resources used by the app.

Last updated on 2020-3-22 by eransharv
← The BasicsUI components →
  • manifest.json
  • windows
    • windows/background
    • windows/in_game
    • windows/desktop
    • windows/AppWindow
  • odk-ts and types
  • icons
  • css and images
  • Legal
  • Terms overview
  • Developer's terms
  • App terms
  • Overwolf terms
  • Overwolf Privacy policy
  • Support
  • Questions and Answers
  • Discord
  • Slack
  • Facebook
  • Twitter
  • Documentation
  • Changelog
  • API
  • App Creation Process
  • Best Practices
  • Game Events status
  • Information
  • Careers
  • Fund
  • Developers Blog
  • Overwolf Appstore
  • Advertise on Overwolf