Installing Foxtrot

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.

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

4. 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