ArmoTuSitio Theme

Four original color themes for VS Code, ArmoTuSitio IDE, and compatible editors.

Español · English · CI y documentación

Preview 0.1.3. Dark Premium retains its graphite status bar while native Activity Bar icons and Status Bar text use original brand yellow. Light and High Contrast Light use softer off-white surfaces to reduce glare while maintaining measured foreground contrast. No CSS gradient injection. Manual editor accessibility acceptance is pending.

Español

Diseño profesional con identidad ArmoTuSitio

ArmoTuSitio Theme extiende al editor la identidad visual verificada de armotusitio.com.ar sin reemplazar el isotipo, modificar el logo corporativo ni sobrescribir preferencias personales.

• Cuatro temas: Dark Premium, Light, High Contrast Dark y High Contrast Light.
• Superficies coherentes: editor, Explorer, Activity Bar, sidebar, tabs, terminal, paneles, Status Bar, navegación, Command Center, chat y notificaciones.
• Sintaxis y semántica: reglas para funciones, tipos, strings, variables, propiedades, estructuras de control, números, comentarios y diagnósticos.
• Accesibilidad: checks automáticos de contraste sobre texto principal y scopes de sintaxis; variantes de alto contraste con objetivos reforzados.
• Rendimiento y privacidad: extensión 100% declarativa, sin Webviews, procesos residentes, telemetría, llamadas HTTP ni dependencias de ejecución.
• Control del usuario: la instalación no cambia el tema activo ni escribe archivos de configuración.

Elegí entre cuatro variantes

Vista conceptual: moodboard de las cuatro variantes (estudio de diseño, no captura funcional).

Capturas auténticas: pendientes de realizar en Extension Development Host con proyectos Go, Java, TypeScript y PHP, así como con la UI del Chat Harness. No se reemplazan por imágenes simuladas.

Identidad visual y relación con ArmoTuSitio IDE

La paleta proviene de tailwind.config.ts, app/globals.css y los SVG oficiales del proyecto ArmoTuSitio. El logo se reutiliza sin modificar los trazos ni la geometría.

Compatibilidad con el IDE: el repositorio Drako01/armotusitio-ide ya incluye los temas nativos ArmoTuSitio Dark y ArmoTuSitio Light; esta extensión ofrece variantes adicionales, no los reemplaza ni modifica el tema predeterminado del IDE. Los nuevos temas aportan colores para los tokens empleados por Control Center, Chat Harness y Account Manager: --vscode-button-secondaryHoverBackground, --vscode-toolbar-hoverBackground, --vscode-testing-iconPassed, --vscode-textCodeBlock-background y estados de validación.

Instalación desde el VSIX validado

Requisito mínimo: VS Code 1.90+ (engines.vscode: ^1.90.0). ArmoTuSitio IDE y otros forks deben soportar las mismas APIs declarativas; el funcionamiento final requiere una instalación real.

1. Abrí GitHub Actions → Preview CI.
2. Elegí una ejecución exitosa del PR de la versión que quieras instalar.
3. Descargá el artifact validated-vsix (requiere sesión de GitHub cuando corresponda).
4. Extraé armotusitio-theme-0.1.3.vsix del ZIP.
5. En el editor: Extensions → … → Install from VSIX… y seleccioná el archivo.

Alternativa por terminal para VS Code:

code --install-extension armotusitio-theme-0.1.3.vsix

En ArmoTuSitio IDE, utilizá el comando específico de su distribución si difiere de code.

Integridad: el artifact también incluye armotusitio-theme-0.1.3.vsix.sha256 para verificar que los bytes instalados son los aprobados por CI.

sha256sum -c armotusitio-theme-0.1.3.vsix.sha256

En Windows PowerShell: Get-FileHash .\armotusitio-theme-0.1.3.vsix -Algorithm SHA256, y compará el digest con el .sha256 incluido.

Selección y personalización voluntaria

Abrí Preferences: Color Theme desde la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P) o utilizá Ctrl+K Ctrl+T en Windows/Linux. Seleccioná una de las cuatro variantes. VS Code conserva tu selección.

Ejemplo de configuración que podés realizar vos, nunca la extensión:

{
  "workbench.colorTheme": "ArmoTuSitio Dark Premium"
}

Los ajustes de workbench.colorCustomizations, editor.tokenColorCustomizations y editor.semanticTokenColorCustomizations del usuario prevalecen conforme a las reglas del editor.

Lenguajes y cobertura

Las reglas genéricas de TextMate y Semantic Highlighting se aplican cuando el editor tiene gramática o servidor de lenguaje compatible:

Importante: Theme no incluye parsers ni language servers. Si una extensión externa cambia los scopes o las leyendas semánticas, los resultados pueden variar. Para diagnosticar un token, ejecutá Developer: Inspect Editor Tokens and Scopes.

Accesibilidad, QA y seguridad

Los tests verifican: contraste mínimo 4,5:1 en pares de texto de la UI y scopes de sintaxis; 7:1 en pares principales de las variantes HC; integridad del manifiesto, existencia de los cuatro temas, resaltado semántico y presencia de tokens usados por la interfaz del IDE.

Estas pruebas no equivalen a certificación WCAG integral. Continúan pendientes la revisión manual en el host real, lectores de pantalla, perfiles de daltonismo y capturas de todas las variantes. Errores, warnings, breakpoints, Git y diff tienen colores específicos.

No solicita permisos adicionales, no ejecuta código durante la activación, no usa red y no incorpora dependencias de runtime. El VSIX se valida como archivo ZIP y se genera su SHA-256.

Resolución de problemas

English

Designed for real development

ArmoTuSitio Theme brings the existing ArmoTuSitio brand system into the editor. It adds four independent color themes for VS Code and compatible forks. It does not alter user settings, replace the IDE's bundled themes, load remote resources, or start background processes.

Highlights: coherent workbench surfaces, syntax + semantic tokens, Git and debugging states, terminal ANSI colors, focused contrast checks, and zero activation/runtime dependencies.

Available themes

Open the design moodboard (concept illustration, not an editor screenshot). Genuine Extension Development Host screenshots are pending.

Install the validated preview

1. Visit the successful Preview CI runs.
2. Download the validated-vsix artifact, extract armotusitio-theme-0.1.3.vsix.
3. In VS Code 1.90+ open Extensions → … → Install from VSIX….
4. Open Preferences: Color Theme and select the desired variant.

Verify the downloaded package against the accompanying .sha256 file. ArmoTuSitio IDE and other compatible forks should be validated on the actual target build.

Supported highlighting depends on grammars or language servers provided by VS Code and installed extensions. Java, Go, JS/TS, Python, PHP, Rust, SQL, YAML, JSON and popular frameworks are covered by general scopes and semantic token mappings.

Accessibility: CI checks selected foreground/background pairs at 4.5:1, and primary high-contrast pairs at 7:1, but full manual accessibility testing is still required. No telemetry, file access, additional permissions, or runtime code.

For issues, use GitHub Issues with the editor version, OS, theme variant, language, reproduction steps, and any relevant screenshots.

Quality & governance

Reproducible development

Node.js 24 is used by the repository's GitHub Actions.

git clone https://github.com/Drako01/theme.git
cd theme
git switch main

npm run check             # generated-file parity, manifest and contrast tests
npm run build             # regenerate themes ONLY after palette/generator changes
npm run package           # build the VSIX without runtime dependencies
python3 scripts/verify-vsix.py dist/armotusitio-theme-0.1.3.vsix

Baseline evidence: [successful Preview CI #43523055218](https://github.com/Drako01/theme/actions/runs/43523055218) passed on Ubuntu, Windows, macOS and VSIX packaging. More recent commits require their own green CI; a previous successful job does not approve modified code.

Release policy

Pull requests must pass tri-OS tests and package the VSIX once. The publishing workflow runs automatically after a version-bumping PR merge to main, confirms the exact reviewed PR SHA/tree and green CI, downloads its original checksummed VSIX and publishes to Marketplace and Open VSX through protected OIDC environments. It does not rerun tests or rebuild the artifact on merge. Manual dispatch remains for recovery.

Current status: 0.1.2 is published via the automated release pipeline; 0.1.3 is pending successful PR CI and merge. Dark Premium editor/syntax surfaces and High Contrast Dark remain unchanged. Genuine screenshots and manual accessibility checks are pending.

Licensing, support and credits

Source code is MIT licensed. The ArmoTuSitio name, trademark and official logo retain their existing brand ownership; this license does not grant rights to third-party trademark use.

The source is original. Material Theme and One Dark Pro were used as usability references only: their code, brands, icons and assets were not copied.

Feedback and bug reports: GitHub Issues. Website: armotusitio.com.ar.

ArmoTuSitio Engineering Tools — Visual identity for engineering work.