Installation

System Requirements

Estudo Organizado is designed to work on any modern device with minimal requirements:

Browser Requirements

Modern Web Browser: Chrome 90+, Firefox 88+, Safari 14+, or Edge 90+
JavaScript Enabled: Required for application functionality
LocalStorage & IndexedDB: For data persistence (enabled by default)
Service Worker Support: For PWA features and offline access

Optional Requirements

For local development server (if not using a pre-configured server):

Python 3.x OR Node.js 14+
Windows: Python is typically pre-installed; Node.js available at nodejs.org

The application itself requires only a web browser. Python or Node.js are only needed to run a local HTTP server.

Installation Methods

Choose the installation method that best fits your environment:

Windows (Recommended)
Manual Setup (Python)
Manual Setup (Node.js)

Using the Windows Launcher

The easiest way to run Estudo Organizado on Windows:

Download the Application

Download or clone the Estudo Organizado repository to your computer.

Locate the Launcher

Navigate to the application folder and find Abrir_Estudo_Organizado.bat Windows Launcher

Run the Launcher

Double-click Abrir_Estudo_Organizado.batThe launcher will:

Start a local Python HTTP server on port 8000
Automatically open the application in your default browser
Display a command window (keep it open while using the app)

Start Studying

The application will open at http://localhost:8000You’re ready to start planning your studies!

Important: Do not close the black command window while using the application. It runs the local server. Close it only when you’re done studying.

What the Launcher Does

The Abrir_Estudo_Organizado.bat file contains:

@echo off
echo ===================================================
echo Iniciando Estudo Organizado via Servidor Local...
echo Por favor, NAO FECHE esta janela preta enquanto estuda!
echo Feche apenas quando terminar de usar o aplicativo.
echo ===================================================
cd "%~dp0src"
start http://localhost:8000
python -m http.server 8000

It automatically:

Changes to the src directory
Opens your browser to http://localhost:8000
Starts Python’s built-in HTTP server

Using Python HTTP Server

Open Terminal

Open your terminal or command prompt and navigate to the application’s src folder:

cd path/to/estudo-organizado/src

Start the Server

Run Python’s built-in HTTP server:

python -m http.server 8000

Or with Python 2:

python -m SimpleHTTPServer 8000

Access the Application

Open your browser and navigate to:

http://localhost:8000

The server will continue running until you press Ctrl+C in the terminal. Keep the terminal window open while using the app.

Using Node.js HTTP Server

Open Terminal

Open your terminal or command prompt and navigate to the application’s src folder:

cd path/to/estudo-organizado/src

Start the Server

Run the Node.js HTTP server using npx:

npx http-server -p 8000

npx comes bundled with Node.js 14+ and will automatically download http-server if needed.

Access the Application

Open your browser and navigate to:

http://localhost:8000

Installing as a Native App (PWA)

Once you have the application running in your browser, you can install it as a Progressive Web App for a native app experience:

Desktop Installation

Open the Application

Navigate to http://localhost:8000 in your browser

Look for Install Prompt

Most browsers will show an install icon in the address bar:

Chrome/Edge: Look for a ⊕ or install icon in the address bar
Firefox: Click the menu (⋮) → “Install Estudo Organizado”
Safari: Not supported on desktop

Install the App

Click the install button and confirm the installationThe app will:

Install as a standalone application
Appear in your Start Menu/Applications folder
Run in its own window without browser UI
Work offline after first load

Mobile Installation (Android)

Open in Chrome

Open the application in Google Chrome on your Android device

Add to Home Screen

Tap the menu (⋮) → “Add to Home screen” or “Install app”

Confirm Installation

Tap “Add” or “Install” in the confirmation dialogThe app will appear on your home screen like a native app

Mobile Installation (iOS)

Open in Safari

Open the application in Safari on your iOS device

Share Menu

Tap the Share button (square with arrow)

Add to Home Screen

Scroll down and tap “Add to Home Screen”

Confirm

Tap “Add” to install the app

PWA Benefits: Once installed, the app works offline, loads instantly, and provides a native app experience without requiring app store downloads.

Service Worker Registration

The application automatically registers a Service Worker for offline functionality. You can verify this in the browser console:

if ('serviceWorker' in navigator) {
    window.addEventListener('load', () => {
        navigator.serviceWorker.register('./sw.js')
            .then(reg => console.log('SW Registrado com escopo:', reg.scope))
            .catch(err => console.error('Erro no registro do SW:', err));
    });
}

From src/index.html:19-26

Verifying Service Worker

To check if the Service Worker is active:

Open Developer Tools (F12)
Go to Application tab (Chrome) or Storage tab (Firefox)
Click Service Workers in the sidebar
You should see sw.js registered and activated

PWA Manifest

The application’s PWA configuration is defined in manifest.json:

{
  "name": "Estudo Organizado",
  "short_name": "Estudo",
  "description": "Aplicativo de Metodologia de Estudo e Organização do Ciclo Contínuo",
  "start_url": "./index.html",
  "display": "standalone",
  "background_color": "#0d1117",
  "theme_color": "#10b981",
  "orientation": "portrait-primary"
}

From src/manifest.json:1-23

Troubleshooting

Server Won’t Start

Problem: python: command not found or similar error Solution:

Ensure Python or Node.js is installed
On Windows, add Python to your PATH during installation
Try using python3 instead of python

Port Already in Use

Problem: Port 8000 is already in use Solution: Use a different port:

# Python
python -m http.server 8001

# Node.js
npx http-server -p 8001

Then access at http://localhost:8001

PWA Won’t Install

Problem: Install button doesn’t appear Solution:

Ensure you’re using HTTPS or localhost
Check that Service Worker is registered (see above)
Try using Chrome or Edge (best PWA support)
Clear browser cache and reload

App Not Working Offline

Problem: App requires internet connection Solution:

Visit the app at least once while online
Check Service Worker is active in DevTools
Wait a few seconds for initial cache to populate
Reload the page to activate Service Worker

If you continue experiencing issues, check the browser console (F12) for error messages. Most issues are related to Service Worker registration or cache configuration.

Next Steps

Now that you have Estudo Organizado installed:

Quick Start Guide

Learn how to create your first study session

Study Organizer

Master the study session timer and tracking

Exam Syllabi

Set up your exam syllabus structure

Configuration

Customize themes, sync, and backups

Get Started

Core Features

Study Planning

Synchronization

Configuration

System Requirements

Browser Requirements

Optional Requirements

Installation Methods

Using the Windows Launcher

What the Launcher Does

Using Python HTTP Server

Using Node.js HTTP Server

Installing as a Native App (PWA)

Desktop Installation

Mobile Installation (Android)

Mobile Installation (iOS)

Service Worker Registration

Verifying Service Worker

PWA Manifest

Troubleshooting

Server Won’t Start

Port Already in Use

PWA Won’t Install

App Not Working Offline

Next Steps

Quick Start Guide

Study Organizer

Exam Syllabi

Configuration

Build docs developers (and LLMs) love

Get Started

Core Features

Study Planning

Synchronization

Configuration

​System Requirements

​Browser Requirements

​Optional Requirements

​Installation Methods

​Using the Windows Launcher

​What the Launcher Does

​Using Python HTTP Server

​Using Node.js HTTP Server

​Installing as a Native App (PWA)

​Desktop Installation

​Mobile Installation (Android)

​Mobile Installation (iOS)

​Service Worker Registration

​Verifying Service Worker

​PWA Manifest

​Troubleshooting

​Server Won’t Start

​Port Already in Use

​PWA Won’t Install

​App Not Working Offline

​Next Steps

Quick Start Guide

Study Organizer

Exam Syllabi

Configuration

Build docs developers (and LLMs) love

System Requirements

Browser Requirements

Optional Requirements

Installation Methods

Using the Windows Launcher

What the Launcher Does

Using Python HTTP Server

Using Node.js HTTP Server

Installing as a Native App (PWA)

Desktop Installation

Mobile Installation (Android)

Mobile Installation (iOS)

Service Worker Registration

Verifying Service Worker

PWA Manifest

Troubleshooting

Server Won’t Start

Port Already in Use

PWA Won’t Install

App Not Working Offline

Next Steps