Scitano/QUICKSTART.md

Scitano 2.0 — Quickstart Guide

System Requirements

Requirement	Minimum	Recommended
Rust toolchain	1.75.0	Latest stable
Operating System	Linux (glibc)	Linux (glibc), macOS
Display server	X11	X11 or Wayland (XWayland)
RAM	512 MB	1 GB
Disk (build)	200 MB	500 MB
Disk (release binary)	5 MB	5 MB

Install Rust (if needed)

# Using rustup (recommended)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

# Verify
rustc --version   # must be >= 1.75.0
cargo --version

Clone and Build

Option 1: Using build.sh (recommended)

git clone https://git.dcos.net/dcosnet/scitano.git
cd scitano
chmod +x build.sh
./build.sh

The build.sh script handles:

• Rust version check (>= 1.75)
• Clean release build with LTO
• Binary size reporting
• Install to ~/.local/bin/ (optional)

Option 2: Manual cargo build

git clone https://git.dcos.net/dcosnet/scitano.git
cd scitano
cargo build --release

The binary is at target/release/scitano.

Option 3: Install system-wide via cargo

git clone https://git.dcos.net/dcosnet/scitano.git
cd scitano
cargo install --path .

This places scitano in ~/.cargo/bin/ (ensure it's in your $PATH).

Run

# From the build directory
./target/release/scitano

# If installed system-wide
scitano

Scitano opens with two sample buffers (hello.rs and script.py) pre-loaded.

First 60 Seconds

1. Save a file — Press Ctrl+O while in the hello.rs tab
2. Cut a line — Move cursor to any line, press Ctrl+K (text from cursor to EOL is killed)
3. Paste it back — Press Ctrl+U to yank the kill-ring
4. Build it — Save first (Ctrl+O), then press Ctrl+B to compile and run the Rust file
5. Check output — Click the "Build Logs" tab in the bottom panel
6. Switch tabs — Click script.py in the tab bar
7. Toggle sidebar — Use View > Toggle Sidebar (or press the menu button)
8. Get help — Press Ctrl+G to see the full hotkey reference in the Messages pane

Linting Support (optional)

Scitano can lint files if the appropriate tools are installed on your system:

Language	Linter	Install
Rust	rustc	Comes with Rust toolchain
Python	python3 -m py_compile	sudo apt install python3
Shell	shellcheck	sudo apt install shellcheck
C	gcc -fsyntax-only	sudo apt install gcc
C++	g++ -fsyntax-only	sudo apt install g++
JavaScript	node --check	sudo apt install nodejs

Lint is triggered by Ctrl+L or Build > ^L Lint Syntax.

Build Tools (optional)

Language	Compiler	Install
Rust	rustc	Comes with Rust toolchain
C	gcc	sudo apt install gcc
C++	g++	sudo apt install g++
Python	python3	sudo apt install python3
JavaScript	node	sudo apt install nodejs
Go	go	sudo apt install golang-go
Ruby	ruby	sudo apt install ruby
Lua	lua	sudo apt install lua5.3
Perl	perl	Usually pre-installed

Build is triggered by Ctrl+B (build+run), or via the Build menu.

Troubleshooting

"No file path. Save first."

Build and run require the file to exist on disk. Press Ctrl+O to save before building.

Display issues on Wayland

Scitano uses iced which relies on winit. On Wayland, ensure XWayland is available:

# Check if XWayland works
WAYLAND_DISPLAY= xdotool --version 2>/dev/null && echo "XWayland OK" || echo "XWayland missing"

Compilation fails with linker errors

On some minimal installs, you may need system libraries:

# Debian/Ubuntu
sudo apt install libx11-dev libfontconfig-dev libfreetype-dev pkg-config

# Fedora
sudo dnf install xorg-x11-devel fontconfig-devel freetype-devel pkgconfig

Slow first build

The first cargo build --release downloads and compiles iced and its dependencies. This takes 3-5 minutes on a typical machine. Subsequent builds are incremental and fast.

Binary Size

With the release profile (LTO, strip, panic=abort), the binary is approximately 4-6 MB depending on the target platform.

Next Steps

• Read the full README.md for complete feature documentation
• Press Ctrl+G inside the editor for the hotkey quick-reference
• Use the Syntax menu to manually override syntax highlighting
• Use the AI-Bridge menu to connect to Aider/Ollama for AI-assisted editing