Unclear. GitHub found no license file, so check the README before reusing the code.

Is minhas_nfes still maintained?

Yes, active. Last change 3 days ago.

How widely used is minhas_nfes?

New, little track record. 0 stars, 1 months old. Look at the code and the owner before running it.

gitmanual

Reading the repo

Opening the box…

How to install minhas_nfes on macOS (GabrielRozendo/minhas_nfes) · gitmanual

How to install on macOS

GabrielRozendo/minhas_nfes

Portal simples para criar e consultar NFS-e Nacional (Emissor Nacional / SEFIN + ADN), com dashboard, API REST e arquivos XML/PDF

Node.jsNext.js

Before you start

Is it free?: UnclearGitHub found no license file, so check the README before reusing the code.
Still maintained?: Yes, activeLast change 3 days ago.
How widely used?: New, little track record0 stars, 1 months old. Look at the code and the owner before running it.

Difficulty: Moderate
Time: about 15 min
Stars: ★ 0
Activity: Updated this month

Saved setup from 7 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Heads-upBuilding it yourself? It also needs 20 settings in .env (4 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

DockerNeeds Docker

docker compose up -d --build

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 6 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js LTS (no version pinned)runtime
1×Docker tool
1×npm package manager

20× settings in .env

CERT_PASSWORDsecret
CODIGO_MUNICIPIO
CPFCNPJ_PRESTADOR
INSCRICAO_MUNICIPAL
NODE_ENV
PORT
DATABASE_PATH
FILES_PATH
CERT_PATH
NFSE_AMBIENTE
DPS_SERIE
VER_APLIC
PDF_TRY_OFFICIAL
AUTH_ENABLED
AUTH_PASSWORDsecret
API_KEYsecret
SESSION_SECRETsecret
ADN_SYNC_MIN_INTERVAL_MS
CIRCUIT_BREAKER_THRESHOLD
CIRCUIT_BREAKER_COOLDOWN_MS

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/GabrielRozendo/minhas_nfes/badge.svg)](https://gitmanual.com/GabrielRozendo/minhas_nfes)

Good to know

Dockerfile available (base image: node:22-bookworm-slim).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.

Details

License: Not detected
Open issues: 0
Branch: main

package.json scripts (8)

devnext dev
buildnpm run build:sdk && next build
build:sdkcd gerador-nfse-nacional-bun && npx tsup && npx tsc -p tsconfig.build.json
postinstallnpm run build:sdk
startnext start
linteslint
typechecktsc --noEmit
submodule:updategit submodule update --remote --merge

Files we read (6)

.env.example

.gitmodules

Dockerfile

README.md

docker-compose.yml

package.json

69 files in the repo

Contact