Skip to content
gtrefPublic

Latest commit

 

History

358 Commits

Folders and files

Repository files navigation

Satiscode Logo

Satiscode

A lightweight, high-performance desktop code editor for C/C++, Python, JSON, XML, and Web languages.
Powered by Electron, Monaco Editor, clangd, Pyright, FIXSON, and FIXML.

CI CodeQL License: MIT Slack Ask DeepWiki AlternativeTo

Download Installer • Usage Guide • Daily News • Changelog • Contributing


Overview

Satiscode combines the power of Microsoft's Monaco Editor with deep, dedicated Language Server Protocol (LSP) integrations for native C/C++, Python, JSON, and XML development—without the heavy memory footprint and overhead of full IDEs.

Tip

Try the latest web preview: Join the beta
Check NEWS.md for daily development logs and ongoing task tracking.


Key Features

Language Intelligence (LSP)

  • C / C++: Full clangd integration providing real-time compiler diagnostics, semantic autocomplete, symbol hover details, and go-to-definition.
  • Python: Microsoft pyright type-checking, code completion, signature help, and diagnostics.
  • JSON: Dedicated @ronna/fixson-lsp engine for strict syntax validation and schema hover.
  • XML: Dedicated @ronna/fixml-lsp engine for XML well-formedness diagnostics, element completion, and tag inspection.
  • Web Standards: Native Monaco syntax parsing and highlight for HTML, CSS, SCSS, JavaScript, TypeScript, and JSX/TSX.

Editor & Workflow Experience

  • Interactive Markdown Mode: Seamless live toggle between rendered HTML preview and raw Markdown editing.
  • Integrated Problems Panel: VS Code-style collapsible diagnostics drawer (Ctrl+.) with clickable error navigation.
  • Built-in Git Version Control: Sidebar integration for tracking file status, staging, committing, pushing, pulling, and inline Git blame.
  • File & Workspace Tree: Fast, resizable directory Explorer with automatic folder root resolution.
  • Tabbed Interface: Multi-buffer tab manager with unsaved change detection and protection.
  • Bilingual Interface: Instant runtime switching between English and Spanish localizations.
  • Themes: Dark, Light, and High Contrast themes with persistent user preferences.

Language Support Matrix

Language Supported Extensions LSP / Engine Core Capabilities
C / C++ .c, .cc, .cpp, .cxx, .h, .hh, .hpp, .hxx clangd Diagnostics, Autocomplete, Hover, Go-to-Definition
Python .py pyright Diagnostics, Completion, Hover, Go-to-Definition
JSON .json FIXSON-LSP Syntax Diagnostics, Autocomplete, Hover
JSONC .jsonc Monaco Built-in Syntax Highlight, Bracket Matching
TOML .toml Monarch Engine Syntax Highlight, Key-Value and Table Formatting
SQL / Databases .sql, .db, .sqlite, .sqlite3 Monaco Built-in Full SQL syntax styling and keyword highlight
XML / SVG / Plist .xml, .xsd, .xsl, .xslt, .svg, .plist FIXML-LSP Well-Formedness Checks, Completion, Hover
Web Technologies .html, .css, .scss, .js, .jsx, .ts, .tsx Monaco Built-in Syntax Highlight, Smart Indent, Bracket Matching
Markdown .md, .markdown Custom Viewer Live Rendered Preview, Split Editing Mode
Plain Text All other files Monaco Built-in High-speed text editing buffer

System Requirements

  • Operating System: Windows 10 or newer (64-bit).
  • Node.js: Version 20.0 or higher (only required for running or building from source).
  • Python: Python 3.8+ required for Python language diagnostics (pyright).

Note

Packaged Windows releases bundle clangd and its support libraries directly—no external LLVM installation is required for normal desktop use.


Quick Start & Development

1. Clone & Install Dependencies

git clone https://github.com/gtref/satiscode.git
cd satiscode
npm install

2. Build Subpackages & Language Servers

npm run build

3. Launch the Application

npm start

Warning

In raw source checkouts, C/C++ diagnostics require clangd.exe located in bin/ (or on your system PATH), and Python diagnostics require pyright in PythonLSP/. npm run build compiles the internal FIXSON and FIXML language server packages.

4. Build the Windows Installer

npm run dist:win

The resulting executable installer is generated in dist/.


Keyboard Shortcuts

Shortcut Action
Ctrl+N Create new document tab
Ctrl+O Open file picker
Ctrl+K Open folder workspace
Ctrl+S Save active file
Ctrl+Shift+S Save active file as new file
Ctrl+F Find in file
Ctrl+. Toggle Problems panel

Project Structure

satiscode/
├── main.js                  # Electron main process & OS process bridge
├── preload.js               # Context-isolated secure IPC bridge
├── index.html               # Monaco editor layout, toolbar, Explorer & Problems drawer
├── packages/
│   ├── FIXSON-LSP/          # JSON Language Server TypeScript source & build
│   └── FIXML-LSP/           # XML Language Server TypeScript source & build
├── UI/                      # Modular UI components (git sidebar, tab manager, markdown)
├── styles/                  # Application stylesheets
├── themes/                  # Theme definitions (dark, light, high-contrast)
├── icons/                   # File-type and UI icon definitions
└── docs/                    # Web IDE implementation and documentation assets

CI/CD Architecture

Satiscode maintains automated testing, security analysis, and distribution checks using GitHub Actions:

Automated Workflows

Workflow File Triggers Description
CI .github/workflows/ci.yml push, pull_request ESLint, TypeScript compiler checks, OS-matrix test runner, asset verification
CodeQL .github/workflows/codeql.yml push, pull_request, weekly Static security analysis for JavaScript & TypeScript
Gitleaks .github/workflows/gitleaks.yml push, pull_request Automated secret detection across commits and PR diffs
Dependency Health .github/workflows/dependency-health.yml push, pull_request, weekly Scans for undeclared and unused dependencies via depcheck
Dependabot .github/dependabot.yml Weekly Automated dependency security and version updates

Local Quality Commands

Always execute the local validation suite before submitting changes:

# Run ESLint validation
npm run lint

# Run TypeScript compilation check across LSP packages
npm run typecheck

# Run test suite
npm test

# Build LSP server bundles and verify distribution assets
npm run build
npm run verify-assets

# Audit dependency health
npm run depcheck

Repository Activity

Repography logo

Timeline graph
Issue status graph
Pull request status graph
Trending topics


Security Model

The editor renderer operates with contextIsolation: true and has no raw Node.js or child process access. All filesystem and LSP process communication is mediated through the audited preload bridge. For details or to report vulnerabilities, see SECURITY.md.


Packages

The internal Language Server Protocol implementations are also published on npm:

Package npm Link Documentation
@ronna/fixson-lsp npm FIXSON-LSP Guide
@ronna/fixml-lsp npm FIXML-LSP Guide

Attributions

This project utilizes software components from clangd (LLVM Project) and Pyright (Microsoft Corporation). Detailed licenses and copyright notices are documented in NOTICES.md.


Contributors

Thanks to the contributors who have helped build and improve Satiscode:


@gtref

@ncs22

@Igcabr01

@ashveet

@coderabbitai

@dependabot
Project Lead Contributor Contributor Contributor Code Review Bot Security Bot

License

Satiscode is open-source software licensed under the MIT License.

Releases

Packages

Used by

Contributors

Languages