How hdasilva59/i-learn-arch-btw works
This is an interactive Linux command-learning web app. Learners explore command guides, submit shell syntax for a plain-language explanation, and work through lessons with practice tasks and progress tracking. The explanation path parses shell syntax, identifies commands and options, and adds specialized interpretations such as find expressions. A simulated terminal supports lesson practice. Source excerpts and the index establish the main wiring; the README is only a generic Next.js starter, so specific product capabilities are inferred from the sampled application modules.
Main entry points: page.tsx Learning interface · command-explainer.ts Command explainer · command-analyzer.ts Command analyzer · command-knowledge.ts Command knowledge
Components 17
Learning experience
- Learning interface
app/page.tsx - Practice terminal
app/terminal.ts - Learning progress
app/learning.ts
Command explanation
- Command explainer
app/command-explainer.ts - Command analyzer
app/command-analyzer.ts - Command knowledge
app/command-knowledge.ts - Guide matching
app/manpage-matcher.ts - Find expressions
app/find-expression.ts
Learning content
- Guide catalog
app/commands/catalog.ts - Command guide domains
app/commands/domains - Command metadata
app/commands/metadata.ts - Lesson catalog
app/courses/catalog.ts - Course validation
app/courses/types.ts - Guide exports
app/commands/index.ts - Course exports
app/courses/index.ts
Shell analysis
- Shell syntax parser
app/shell-ast.ts
Other components
- Learner
Connections 24
- Learner → Learning interface: uses
- Learning interface → Command explainer: requests explanations
app/page.tsx - Learning interface → Practice terminal: runs practice
app/page.tsx - Learning interface → Learning progress: updates progress
app/page.tsx - Learning interface → Guide exports: loads guides
app/page.tsx - Learning interface → Course exports: loads lessons
app/page.tsx - Command explainer → Shell syntax parser: parses syntax
app/command-explainer.ts - Command explainer → Guide matching: identifies commands
app/command-explainer.ts - Command explainer → Find expressions: parses find
app/command-explainer.ts - Command explainer → Command analyzer: analyzes commands
app/command-explainer.ts - Command explainer → Command knowledge: uses command knowledge
app/command-explainer.ts - Command analyzer → Shell syntax parser: parses syntax
app/command-analyzer.ts - Command analyzer → Find expressions: parses find
app/command-analyzer.ts - Command analyzer → Guide matching: matches guides
app/command-analyzer.ts - Command analyzer → Command knowledge: uses knowledge
app/command-analyzer.ts - Command knowledge → Guide matching: resolves guide
app/command-knowledge.ts - Command knowledge → Command metadata: uses metadata
app/command-knowledge.ts - Guide matching → Shell syntax parser: reads parsed words
app/manpage-matcher.ts - Find expressions → Shell syntax parser: parses nested shell
app/find-expression.ts - Guide catalog → Command guide domains: assembles domains
app/commands/catalog.ts - Lesson catalog → Guide catalog: validates task guides
app/courses/catalog.ts - Lesson catalog → Course validation: validates lessons
app/courses/catalog.ts - Guide exports → Guide catalog: exports guides
app/commands/index.ts - Course exports → Lesson catalog: exports lessons
app/courses/index.ts