Skip to main content

Operations

Prerequisites​

  • Node.js 22+
  • pnpm
  • Rust toolchain (for desktop builds)
  • WebView2 Runtime (Windows)
  • Docker, Git, MongoDB, DuckDB, SSH/FTP targets, and Winget as needed for the sections actually used

Install​

pnpm install
pnpm approve-builds

Run the web development server​

pnpm dev

Then open http://localhost:3000.

Build​

# Web app only
pnpm build

# Full desktop installer (compiles the Next.js standalone server, stages
# static assets, copies the bundled Node runtime, builds the Tauri app,
# and emits the NSIS installer)
pnpm tauri:build

The current packaged version is 1.0.8, with the installer produced at:

src-tauri/target/release/bundle/nsis/AptConsole_1.0.8_x64-setup.exe

Verification​

pnpm lint
pnpm exec tsc --noEmit
cargo check --manifest-path src-tauri/Cargo.toml
pnpm tauri:build

Known, expected build noise: Next.js may warn about multiple lockfiles / inferred workspace root, and baseline-browser-mapping may warn its data is stale — neither indicates a real problem.

Project structure​

AptlantisConsole/
├── app/          # Next.js App Router and API routes
├── components/   # Dashboard sections, shared UI, Docker tools, terminal UI
├── docs/         # Feature docs, design notes, patch reports
├── hooks/        # Client-side React hooks
├── lib/          # Server utilities, integrations, config, operations, terminal server
├── patches/      # Patch report templates and release note helpers
├── public/       # Static assets
├── scripts/      # Build, smoke-test, and packaging helpers
├── src-tauri/    # Tauri 2 Rust shell, permissions, capabilities, bundle config
└── server.ts     # Next.js standalone server entry