tina4 3.5.1

Tina4 — Unified CLI for Python, PHP, Ruby, and Node.js frameworks
tina4-3.5.1 is not a library.

tina4

Unified CLI for the Tina4 framework — Python, PHP, Ruby, and Node.js.

A single Rust binary that auto-detects your project language, compiles SCSS, watches files for hot-reload, and delegates to the language-specific CLI.

Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/tina4stack/tina4/main/install.sh | sh

Or with wget:

wget -qO- https://raw.githubusercontent.com/tina4stack/tina4/main/install.sh | sh

The script auto-detects your OS and architecture, downloads the correct binary from the latest GitHub release, and installs it to /usr/local/bin. Override the install location with:

TINA4_INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/tina4stack/tina4/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/tina4stack/tina4/main/install.ps1 | iex

Installs to %LOCALAPPDATA%\tina4 and automatically adds it to your user PATH. Open a new terminal after installation.

Homebrew (macOS / Linux)

brew install tina4stack/tap/tina4

From source (requires Rust)

cargo install --git https://github.com/tina4stack/tina4.git

Manual download

Pre-built binaries for every platform are attached to each GitHub release:

Platform Binary
macOS ARM64 (Apple Silicon) tina4-darwin-arm64
macOS x86_64 (Intel) tina4-darwin-amd64
Linux x86_64 tina4-linux-amd64
Linux ARM64 tina4-linux-arm64
Windows x86_64 tina4-windows-amd64.exe

Quick start

# Check your environment

tina4 doctor


# Create a new project (prompts for language if multiple runtimes are installed)

tina4 init php ./my-app


# Start the dev server with SCSS compilation and hot-reload

cd my-app

tina4 serve

Commands

Command Description
tina4 doctor Check installed languages, package managers, and Tina4 CLIs
tina4 install <language> Install a language runtime (python, php, ruby, nodejs)
tina4 init [language] <path> Scaffold a new Tina4 project. Prompts for language if not specified and multiple runtimes are available
tina4 serve [--port N] [--dev] [--production] Compile SCSS, start the dev server, and watch for changes
tina4 scss [-w] Compile SCSS files (src/scss → src/public/css). Use -w to watch
tina4 migrate [--create <name>] Run database migrations or create a new one
tina4 test Run project tests
tina4 routes List registered routes
tina4 generate <type> <name> Generate scaffolding: model, route, migration, middleware
tina4 ai [--all] [--force] Detect AI coding tools and install framework context/skills
tina4 upgrade Upgrade a v2 project to v3 structure
tina4 update Self-update the tina4 binary and clean up old v2 CLIs
tina4 books Download the Tina4 documentation book

How it works

  1. Language detection — scans for pyproject.toml, composer.json, Gemfile, or package.json to determine the project language
  2. SCSS compilation — uses the grass crate (pure Rust Sass compiler) so individual frameworks don't need their own SCSS compilers
  3. File watching — monitors src/, migrations/, and .env for changes; recompiles SCSS and restarts the dev server automatically
  4. Delegation — forwards commands like migrate, test, routes, and ai to tina4python, tina4php, tina4ruby, or tina4nodejs as appropriate
  5. Self-update — tina4 update checks GitHub releases and replaces the binary in-place. Also detects and removes old v2 CLI binaries that may be shadowing the new CLI

Upgrading from v2

If you have an older v2 Tina4 project, run tina4 upgrade inside the project directory. This will:

  • Move top-level directories (routes/, orm/, templates/, etc.) into src/
  • Update dependency versions in your manifest file to v3
  • Delegate any language-specific code changes to the framework CLI

If you have old v2 CLI binaries (tina4python, tina4php, etc.) installed globally, tina4 update will detect and remove them.

License

MIT