Getting started

Fiction uses most popular and pre-installed dependencies and has support for multiple cores for network.

Requirements

• bash 4.0+ (4.* support in theory, not fully tested)
• GNU coreutils
• netcat/ncat/socat (optional, for HTTPS and fork support)
• awk, grep, sed (mostly preinstalled)

Installation

Note

By default, Fiction uses socat for connection.

If your machine doesn’t include socat, change core option to bash (core=bash) or other supported core, or install socat with your system’s package manager if possible.

src/index.shx

fiction.server "0.0.0.0:8080" core="socat"
fiction.server "0.0.0.0:8080" core="bash"

1. Install Fiction by cloning the github directory

   git clone https://github.com/FictionWeb/framework

2. Go to the framework directory

   cd framework

3. Make bashx and fiction executable binaries

   ln -s $(pwd)/fiction.so.sh /usr/bin/fiction && chmod +x /usr/bin/fiction
   ln -s $(pwd)/modules/bashx /usr/bin/bashx && chmod +x /usr/bin/bashx

4. Start the server

   fiction

   fiction dev

   bash

   Fiction would automatically load and execute the main file with bashx

   bash src/index.shx

   bashx

   You can also use bashx directly to start the file

   bashx src/index.shx

5. Check if the server is working

   Open <server IP>:8080 in your browser; If you see the default page, Fiction is working and you can start editing the code in index.shx file in src folder.