NPShopSwitch

Exportacao publica saneada do app/homebrew do Nintendo Switch, preparada para colaboracao comunitaria em 29 de agosto de 2026.

PT-BR

Escopo

Este repositorio contem o cliente principal do Switch, assets de romfs, codigo compartilhado em include/ e experimentos/modulos auxiliares preservados para continuidade tecnica da comunidade.

O export removeu:

• credenciais, seeds, tokens, certificados e outros artefatos sensiveis
• fluxos de setup online privado e instalacao automatica de kit
• referencias pessoais e apontamentos obrigatorios para a infraestrutura antiga

Estrutura

• source/: app principal e modulos de runtime
• include/: headers compartilhados
• romfs/: assets empacotados no .nro
• sysmodule/: codigo legado/experimental mantido para estudo, nao como caminho principal de build
• config.example.json: base de configuracao do app no SD

Requisitos de Build

• devkitPro
• libnx
• cmake
• make
• git

Build Local

./build.sh --channel stable --version 0.1.0-community

Artefato principal esperado:

• build/NPShopSwitch.nro

Se quiser passar um diretorio de saida:

./build.sh --channel stable --version 0.1.0-community --output-dir ./dist

Build via Docker

docker compose run --rm build --channel stable --version 0.1.0-community

Configuracao

O app le sdmc:/switch/NPShop/config.json.

Passos:

cp config.example.json /tmp/config.json

Depois ajuste manualmente api_url para a API hospedada pela comunidade e copie o arquivo final para sdmc:/switch/NPShop/config.json.

Colaboracao

• mantenha toda URL/base externa configuravel por arquivo ou env; nao reintroduza dominios privados como fallback
• nao commite config.json com dados reais de deploy, tokens, chaves ou dumps
• documente mudancas de protocolo entre backend e app em PRs e issues
• trate source/modules/setup como placeholder do export comunitario, nao como instalador funcional
• prefira PRs pequenos e testaveis, com descricao objetiva do comportamento alterado

Estado do Export

• o fallback padrao de rede aponta para https://community.example.invalid
• o setup privado foi explicitamente desativado para o build continuar sem carregar infraestrutura antiga

EN

Scope

This repository contains the main Nintendo Switch client, romfs assets, shared headers in include/, and preserved auxiliary/experimental modules for community continuation.

This public export removes:

• credentials, seeds, tokens, certificates, and other sensitive operational material
• private online setup flows and automatic kit installation
• personal references and mandatory ties to the previous infrastructure

Layout

• source/: main app and runtime modules
• include/: shared headers
• romfs/: assets packed into the .nro
• sysmodule/: legacy/experimental code kept for study, not the primary build target
• config.example.json: base SD configuration for the app

Build Requirements

• devkitPro
• libnx
• cmake
• make
• git

Local Build

./build.sh --channel stable --version 0.1.0-community

Expected primary artifact:

• build/NPShopSwitch.nro

Optional output directory:

./build.sh --channel stable --version 0.1.0-community --output-dir ./dist

Docker Build

docker compose run --rm build --channel stable --version 0.1.0-community

Configuration

The app reads sdmc:/switch/NPShop/config.json.

Start from config.example.json, set api_url to your community-hosted backend, then copy the final file to sdmc:/switch/NPShop/config.json.

Collaboration

• keep every external base URL configurable by file or env; do not reintroduce private domains as fallback behavior
• do not commit real deployment configs, tokens, keys, or device/account dumps
• document backend/app protocol changes in PRs and issues
• treat source/modules/setup as a community-export placeholder, not a working private installer
• prefer small, testable PRs with a direct description of the behavior change

Export Status

• the default network fallback now points to https://community.example.invalid
• private setup features were intentionally disabled so the project can build without the previous private infrastructure