패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소romiojoseph/scaffold

scaffold

프로젝트 탐색, 디렉터리 트리 및 토큰 분석, 커밋 기록 인사이트, 크로스 프로젝트 종속성 관리 및 암호화 파일 해싱을 위한 플러터 윈도우 개발자 유틸리티.

scaffold 프로젝트 이미지
스타
0
포크
0
최근 푸시(UTC)
2026. 9. 26.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

Scaffold

A Flutter Windows developer utility for project exploration, code analysis, and other development workflows.

About

Scaffold started as a simple PowerShell script. The original purpose was to quickly generate project structures and collect useful information that could be shared with AI tools. The script was converted into a desktop application as an experiment. The goal was simple. A simple UI for a few commands I mostly use. Over time, more features were added, turning it into a lightweight project explorer and analysis tool.

This is a vibe-coded project, built entirely with AI assistance. I handled the design and UX myself, while the logic was AI-generated and refined through iterative prompting. Use it or fork it.

*If you are going to clone and build this app yourself, make sure to download a tokenizer.json from huggingface (not included because of the file size). I used this one https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-0731/tree/main


Source Code Distribution

This repository contains the source code only. Pre-built Windows executables, installers, or ZIP releases are not provided. The source code is shared so developers (even a non dev can build with the help of AI) can:

  • Inspect the implementation
  • Understand the approach
  • Experiment with the application
  • Modify features
  • Build their own version

You can build the application locally using Flutter Windows.


Features
Project Scanner

Scan any project directory and analyse its structure. Provides information about:

  • Files
  • Folders
  • File types
  • Directory structure
  • Line counts
  • Code statistics

Multiple Output Views
Tree View

Visual representation of the scanned project structure. Useful for:

  • Understanding unfamiliar repositories without opening an IDE
  • Reviewing project organisation
  • Sharing project context
ASCII View

Generate a text-based project structure. Useful for:

  • AI prompts
  • Documentation
  • Code reviews
  • Project discussions

ASCII output can be copied or trimmed down to the base.


Code Statistics

The statistics view provides detailed project analysis.

  • Total files
  • Total lines
  • Code lines
  • Comment lines
  • Blank lines
  • Language-wise breakdown
  • Individual file statistics
  • Estimated token count (experimental feature) - based on tokenizer.json downloaded from huggingface (deepseek-ai/DeepSeek-V4-Flash-0731) and then used https://pub.dev/packages/hf_tokenizers.

The generated table can be copied as Markdown and used directly in documentation or AI tools.

Example use cases:

  • Understanding project size
  • Finding large files
  • Reviewing code distribution
  • Planning refactoring

For counting code, the binary built with Tokei (cargo install --git https://github.com/XAMPPRocky/tokei.git tokei) is used. It has been added to assets\third_party\tokei\tokei.exe.

Extracted Code Comments Explorer

Scan and extract comments across all project source files.

  • File-Based View: Collapsible file cards showing line badges and comment text with one-click navigation to the file viewer.
  • Markdown View: Formatted project comment summary.
  • Export Options: Export all filtered comments to a JSON file or copy individual file comments / full summary as Markdown.

Supported file types & comment formats:

  • C-Style (//, ///, /* */): .dart, .js, .ts, .jsx, .tsx, .java, .c, .cpp, .h, .hpp, .cs, .go, .rs, .kt, .swift, .php, .scala
  • Hash-Style (#): .py, .yaml, .yml, .sh, .bash, .ps1, .rb, .toml, .env, .r, .pl, .pm, Dockerfile
  • HTML / XML-Style (<!-- -->): .html, .htm, .xml, .svg, .vue, .svelte
  • CSS-Style (/* */): .css, .scss, .sass, .less
  • Dash-Style (--): .sql, .lua, .hs

Git History

If Git is initialized in the selected directory, Scaffold displays the commit history along with commit activity, line changes, authors, and code frequency metrics. It's useful for understanding the project's evolution and development patterns over time.

  • Commit list with author, date, message, and commit hashes
  • Direct links to commit URLs on GitHub or any other origin.
  • File-level additions, deletions, and status breakdowns per commit
  • Working Tree Changes: Real-time staged, modified, and untracked file breakdown with category tabs (All, Staged, Modified, Untracked) and scoped bulk file path copy.
  • Get Commit Data: Export JSON payload or aggregated file changes across any selected commit range, with date-aware commit selectors.
Dependencies

Inspect packages and dependencies used across the project. Scaffold automatically scans for package manifests across the directory tree.

Supported package manifests & ecosystems:

  • Flutter / Dart: pubspec.yaml (via pub.dev)
  • Node.js / JavaScript / TypeScript: package.json (via npmjs.org)
  • Rust: Cargo.toml (via crates.io)
  • Go: go.mod (via proxy.golang.org)
  • Python: pyproject.toml and requirements.txt (via PyPI)

Included:

  • Live version check against official package registries
  • Outdated package identification with latest published version details
  • Security vulnerability and advisory checks (via OSV database)
  • License, repository links, changelog links, and published dates

Global Packages Manager

A centralized dashboard accessible from the title bar to audit packages across multiple projects simultaneously.

Features:

  • Discovers and indexes manifests across all recent projects in history
  • Aggregates package usages to detect cross-project version drift
  • Filters by ecosystem, outdated status, or security vulnerabilities

Developer Environment & Tools Inspector

A system-level tooling auditor accessible from the title bar to inspect local runtimes, mobile SDKs, package managers, and databases on Windows.

Supported tool categories & inspections:

  • Runtimes: Node.js, Bun, Deno, Python, Go, Rust (rustc), Visual Studio Build Tools (vswhere), Java (JDK), Kotlin
  • Mobile: Flutter, Dart, Android SDK (adb)
  • Packages: npm, pnpm, Yarn, pip, Cargo
  • Databases: Git, PostgreSQL (psql), SQLite3

Features:

  • Live Status & Path Detection: Non-blocking asynchronous checks detecting installed versions and executable binary paths.
  • Release-Aware Update Checks: Checks online registries with major/minor branch awareness to show when newer updates are available.
File Line Threshold

Set custom limits for file sizes. The purpose is to identify files that have become too large and may need refactoring. Example:

TSX files: 600 lines
Dart files: 500 lines

Files exceeding the configured threshold will be highlighted for review. Threshold values are completely customisable based on personal workflow preferences.


Exclusion Management

Control which files and folders are included during scanning.

Custom Exclusions

Add files, folders, or path-based patterns. Examples:

*.log
node_modules
build
windows/flutter
build/flutter_assets

Patterns can be:

  • Bare names — match any file or folder with that name anywhere in the tree (e.g. build, *.log)
  • Path-based — match only at a specific location relative to the scanned root (e.g. windows/flutter, build/flutter_assets)
  • Extensions — patterns starting with . match by extension (e.g. .svg, .png)

Both / and \ are accepted as path separators and are treated identically.

Presets

Includes presets for common development environments:

  • General
  • Web
  • Flutter
  • Python
  • Rust
  • Go
  • Kotlin
  • Docker
Exclusion Engine Toggle

Enable or disable the manual exclusions list independently. When disabled, all manually configured patterns are skipped during scanning.

Git Ignore Mode

Optionally scan using .gitignore rules from the project root. When enabled, gitignore patterns are applied in addition to any manual exclusions that are configured. The manual exclusion engine toggle still applies — if it is off, only gitignore rules are used.

The .gitignore file must exist in the scanned root directory. If it is not found, gitignore mode is automatically turned off.


Workspaces & Directory History

All project paths are stored in history and managed through the slide-out Workspaces drawer.

Features:

  • Workspace History: Quickly switch between previously scanned projects or remove old entries.
  • Parent Dev Folder Discovery: Automatically scan a parent directory to discover and import all nested Git repositories at once.
  • Live Git Workspace Tracking: Real-time repository status for each workspace without switching projects:
    • Current active branch
    • Uncommitted changes (staged, unstaged, untracked)
  • Filter & Search: Filter workspaces by state (All, Changes, Unpushed, Clean, Non-Git) or search by folder name and path.
  • Quick Actions: Open directory directly in Windows Explorer or integrated terminal.

Export

Scan results can be exported as a structured JSON file. The exported file includes:

  • Root path and folder name
  • Scan date
  • Active exclusion patterns
  • Full directory structure with file metadata

This is useful for archiving snapshots, sharing project structure, or comparing state over time.


Snapshot Compare

Scaffold supports comparing project snapshots over time. Workflow:

  1. Scan a project
  2. Export the scan result as JSON
  3. Continue development
  4. Scan again later
  5. Compare snapshots

This helps understand changes between two points in a project's development.


Dedicated File Viewers

Scaffold includes specialized viewers and editors tailored for common developer configuration, data, and markup files:

JSON & JSON Lines Viewer (.json, .jsonl, .ndjson)
  • Interactive Tree: Explore nested objects and arrays with instant expand/collapse.
  • Independent Copy: Click any key to copy the key name, or click any value to copy the raw value.
  • Schema Skeleton Mode: Generate and copy clean structural schemas stripped of data values.
  • Search & Filter: Highlight matching keys and values in real-time.
  • Handles files up to 30 MB.
SVG Viewer (.svg)
  • Vector Canvas: Interactive pan, pinch, and zoom controls (10% to 1000%).
  • Background Modes: Switch canvas between Dark, Checkerboard, and Light modes for optimal asset visibility.
  • Metadata & Export: View file size, and one-click copy of raw SVG XML or Data URI.
  • Side-by-Side XML Inspector: Formatted and syntax-highlighted XML code panel.
Global SVG Gallery & Scanner

A folder-wide SVG scanner accessible from the title bar menu:

  • Grid Presentation: Responsive grid with quick density toggle.
  • Metadata & Previews: Displays live rendered vector previews, file names, relative paths, and formatted sizes.
  • Sort & Search: Real-time keyword filtering and sorting (by Name, Size, Date modified).
  • Quick Actions: Click any card to open the dedicated full-screen SVG Viewer or copy SVG XML in one click.
Config & Markup Viewer (.yaml, .toml, .env, .ini, .lock, etc.)

Dedicated syntax-highlighted viewer with line numbering, word wrap toggle, real-time line filtering, and multi-line selection support:

  • YAML: .yaml, .yml
  • TOML: .toml
  • Environment Files: .env, .env.*
  • Configuration Files: .ini, .cfg, .conf, .properties
  • Ignore & Tool Configs: .gitignore, .dockerignore, .editorconfig
  • Lockfiles: pubspec.lock, Cargo.lock, yarn.lock, pnpm-lock.yaml, poetry.lock, .lock

Ways to open files in Viewer:

  • Double-click any supported file in Windows Explorer (when set as default app)
  • Use the Open file button in the title bar
  • Click any supported file while browsing in Tree View mode

CSV Editor & Diff
  • CSV Viewer & Editor: View tabular data with search, sorting, and cell editing capabilities (.csv, .tsv).
  • CSV Diff: Compare two CSV files with highlighted row and column differences.

Windows Integration
Folder Context Menu

Scaffold can be added to the Windows folder context menu. After enabling it:

Right Click Folder → Show More Options → Open with Scaffold

Windows 11 places custom shell integrations inside "Show More Options" unless deeper shell integration is implemented.

Default App for Supported Files

Scaffold can register itself as the default application for supported file formats (.json, .jsonl, .ndjson, .yaml, .toml, .env, .ini, .cfg, .conf, .properties, .gitignore, .dockerignore, .editorconfig, .lock, .csv, .tsv, .svg) via Windows registry (HKCU, no admin privileges required). This can be toggled with a single switch from Settings.


Application Data

Application data is stored inside the Windows AppData directory. A shortcut is available from Settings to open the application data folder directly.

Stored data includes:

  • Exclusion patterns
  • Line threshold configuration
  • Path history

File Type Distribution

View project composition based on file types. Shows:

  • File extensions
  • Number of files
  • Distribution of project formats

Useful for quickly understanding the technology mix of a repository.


File Hash & Encryption

A utility screen for generating file checksums and password-protecting files with encryption.

Features:

  • File Hashing: Generate both SHA-256 and SHA-512 hashes for multiple files at once.
  • Click to Copy: Click any hash value to quickly copy it to your clipboard.
  • Export Hashes: Save the generated hash list as a CSV or JSON file (with an option to hide local file paths).
  • Encrypt Files: Password-protect any file into an encrypted .enc file.
  • Decrypt Files: Restore your original .enc files by entering the password. If the password is wrong or the file is corrupted, it will let you know.

Technology Stack

Built with:

  • Flutter
  • Dart
  • Flutter Windows Desktop

Key dependencies:


Project Structure
lib/
├── models/
│   ├── Data models and configuration classes
│   └── Scan, exclusion, threshold, dependency, and diff models
│
├── screens/
│   ├── HomeScreen (main scanner & multi-tab explorer)
│   ├── FileHashScreen (hashing & file encryption)
│   └── GlobalDependenciesScreen (cross-project package audit)
│
├── services/
│   ├── File scanner & Tokei line analysis
│   ├── Developer environment & runtime update inspector
│   ├── Cryptography, hashing & Windows CNG integration
│   ├── Dependency manifest parser & registry version checker
│   ├── Git history & commit parser
│   ├── BPE tokenizer & registry
│   ├── Export service
│   ├── Icon mapping configuration
│   └── Windows shell integration
│
├── theme/
│   ├── App colors (AppColors)
│   ├── Typography (AppTypography)
│   ├── Spacing (AppSpacing)
│   └── Theme configuration (AppTheme)
│
├── utils/
│   └── Shared utility functions (clipboard, formatting, terminal, URLs)
│
├── widgets/
│   ├── common/         # Reusable design system UI components
│   ├── deps/           # Project dependency cards and views
│   ├── environment/    # Developer environment inspector dialog & tool cards
│   ├── file_hash/      # Checksum tables and crypto cards
│   ├── git/            # Git commit lists, range exporters, and frequency charts
│   ├── global_deps/    # Global package tables and filters
│   ├── home/           # Progress banners and main tab controls
│   ├── stats/          # Metric cards and language breakdown charts
│   ├── viewers/        # File viewer and JSON schema skeleton preview
│   └── Feature-specific views (Tree, ASCII, Stats, Dependencies, Git)
│
└── main.dart

assets/
├── icons/              # General UI SVG icons
├── mapping/            # File extension and language SVG icons
├── third_party/        # Bundled Tokei binary & tokenizer assets
├── iconMapping.json    # Extension-to-icon mapping config
└── AppIcon.png

test/
└── Widget tests

Build From Source
Requirements
  • Flutter SDK
  • Windows development environment
  • Visual Studio with Windows desktop development tools
Tokenizer Setup (Required for Token Estimation)

To calculate accurate byte-exact token counts, download the HuggingFace tokenizer.json file for your model (e.g. DeepSeek / Llama / GPT) and place it at:

assets/third_party/tokenizer/tokenizer.json

(Note: tokenizer.json is excluded from git version control due to file size).

Install Dependencies
flutter pub get
Run

For development, use your preferred IDE's Flutter debug mode instead of running through the terminal.

IDE-powered debugging provides:

  • Instant hot reload
  • Hot restart support
  • Integrated debugging tools
  • Faster development iteration

Recommended workflow:

  • Open the project in your Flutter-supported IDE.
  • Select the Windows device target.
  • Start the application using the IDE's Run/Debug option.
Build Windows Application
flutter build windows

After building, go to build\windows\x64\runner\Release\ and copy the entire Release folder to a permanent location, for example C:\Tools\Scaffold, and run it from there.


Current Status

This application was created mainly around personal development workflows. The future direction depends on continued usage and real-world needs. Features may continue to evolve as more problems are discovered during regular development work.


License

This project is shared as source code for learning, experimentation, modification, and personal development workflows. Refer to the repository license for usage details.

Romio Joseph GitHub avatar
GitHub 작성자

Romio Joseph ↗

I like working at start-ups and helping with open-source projects. I'm excited about the future of digital creation through natural language and no-code tools.

언어DartC++CMakeC

분류

사용 중인 의존성

의존성 목록 17 개

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗