Live Development Environment

include.sh logo include_server

A lightweight, dynamic development server for projects using include.sh. See your changes in real-time with automated rendering and smart port management.

Dynamic Workflow

Stop manual builds. Let the server handle the rendering.

Dynamic Rendering

Runs include_processor on every request, ensuring your browser always reflects the latest changes.

Smart Ports

Automatically picks a random available port between 8000-9000 to avoid local conflicts.

Auto-Browser

Launches your default web browser automatically as soon as the server starts.

Mirrored Serve

Serves files directly from the _included/ directory for consistent production-like paths.

Instant Feedback Loop

The server removes the friction between editing and previewing. Just run the command in your project root and start coding.

No need to restart the server after edits

Zero configuration required

Stop instantly with Ctrl+C

bash — 80x24
# Navigate to project
cd ~/my_modular_site
❯ include_server
🚀 Server starting...
Port selected: 8421
Opening browser to http://localhost:8421
Listening for requests...
# Edit any .include.html file and refresh browser
Changes applied instantly!

Prerequisites

The server relies on the core engine and a few system utilities.

include.sh

The core engine that handles the actual file inclusion logic.

curl -L https://include-sh.codeberg.page/include.sh -o include.sh
chmod +x include.sh
sudo cp include.sh /usr/local/bin/include

include_processor

Handles directory-wide expansion into the _included/ folder.

curl -L https://include-sh.codeberg.page/include_processor.sh -o include_processor.sh
chmod +x include_processor.sh
sudo cp include_processor.sh /usr/local/bin/include_processor

socat

Used for handling TCP connections for the local server.

# macOS brew install socat
# Ubuntu sudo apt-get install socat

Installation

Step 1
# Download the server script
curl -L https://include-sh.codeberg.page/include_server.sh -o include_server.sh
Step 2
# Make executable
chmod +x include_server.sh
Step 3
# Add to system path
sudo cp include_server.sh /usr/local/bin/include_server
sudo chmod +x /usr/local/bin/include_server