Skip to content
This repository has been archived by the owner on Oct 10, 2023. It is now read-only.

Installing Foxtrot

Gabriel edited this page Jun 14, 2021 · 10 revisions

Prerequisites

The only prerequisite is to have a local PHP 7 web server running.

A quick and easy way to set up a local testing/development server, specially on Windows, is using WAMP or XAMPP. Just download it, run the installer and follow the steps.

Also, note that only up-to-date modern browsers are supported and that so far testing has been done on WebKit browsers (Opera, Chrome, new Edge) only.

Downloading and building Foxtrot

We don't offer pre-built releases yet. But building Foxtrot only takes one click.

  1. Download the source code from GitHub: https://github.com/gquagliano/foxtrot-framework/archive/refs/heads/master.zip

    You may notice that the full source code is quite large. That's because it does come with a couple of third party libraries to do complex stuff like generating PDFs or reading Excel files. But, if you don't use them, your app will be much smaller.

  2. Extract foxtrot-framework-master into your local server's folder. If you installed XAMPP, by default that should be c:\xampp\htdocs\.

    You can rename foxtrot-framework-master, or extract everything directly on your server's document root; if you do so, just change the links on the following steps as required.

Warning!

The app manager and the editor are designed for personal use on a local and private server (just like a desktop app). Uploading the /construir and /gestor folders to a shared server will have severe security implications.

  1. Open http://localhost/foxtrot-framework-master/construir in your browser.

  2. Click Construir Foxtrot (Build Foxtrot).

If you see the following message, it's done.

Opening the app manager

Open http://localhost/foxtrot-framework-master/gestor in your browser.

Running the current app

Open http://localhost/foxtrot-framework-master/desarrollo in your browser. No compilation or build process is required.

Foxtrot can host multiple apps. While on production the system would choose which app to run based on the domain name (or other custom procedure you may have written), on a development server (i.e. when you open /desarrollo, which means development) it will run the app that has been selected in the app manager.

Next

Overview of the app manager