How sardehmoghadam/asvscanvas works
ASVS Academy is a static-first OWASP ASVS training portal. Learners browse chapters and sections to reach individual controls, which present validated MDX lessons; they can also search the control corpus or consult contribution guidance. The map separates routes, structured learning content, reusable presentation, and search/metadata services. Some route and component source was not excerpted, so relationships are included only where the README or SOURCE INDEX documents them; the control MDX directory is described in the README but absent from the supplied tree.
Main entry points: loader.ts Control content loader · [slug]/page.tsx Chapter page · app/page.tsx Home page · [slug]/page.tsx Control lesson
Components 24
Learning routes
- Home page
app/page.tsx - Chapter page
app/categories/[slug]/page.tsx - Section page
app/sections/[slug]/page.tsx - Control lesson
app/controls/[slug]/page.tsx - Search page
app/search/page.tsx - Contribute guide
app/contribute/page.tsx
Learning content
- Chapter catalog
content/categories.ts - Section catalog
content/sections.ts - Control content loader
lib/content/loader.ts - Content validation
lib/content/schema.ts - ASVS configuration
config/standard.ts - Content types
types/content.ts
Presentation
- Documentation layout
components/docs-layout.tsx - Learning cards
components/cards.tsx - Breadcrumb navigation
components/breadcrumbs.tsx - Search box
components/search-box.tsx - Search results UI
components/search-client.tsx - MDX headings
lib/content/headings.ts - Site shell
app/layout.tsx
Search and metadata
- Search index
lib/search.ts - Markdown text
lib/content/markdown-text.ts - Site metadata
lib/site-config.ts - Structured data
lib/structured-data.ts
Other components
- Learner
Connections 33
- Learner → Home page: opens
README.md - Learner → Search page: searches
README.md - Learner → Contribute guide: reads guidance
README.md - Home page → Chapter catalog: presents chapters
app/page.tsx - Home page → Control content loader: loads controls
app/page.tsx - Home page → Learning cards: renders cards
app/page.tsx - Home page → Search box: renders search
app/page.tsx - Chapter page → Chapter catalog: looks up chapter
app/categories/[slug]/page.tsx - Chapter page → Section catalog: loads sections
app/categories/[slug]/page.tsx - Chapter page → Control content loader: loads controls
app/categories/[slug]/page.tsx - Chapter page → Section page: links to sections
app/categories/[slug]/page.tsx - Chapter page → Control lesson: links to controls
app/categories/[slug]/page.tsx - Chapter page → Learning cards: renders section cards
app/categories/[slug]/page.tsx - Section page → Control content loader: loads controls
app/sections/[slug]/page.tsx - Section page → Documentation layout: uses layout
app/sections/[slug]/page.tsx - Section page → Breadcrumb navigation: renders trail
app/sections/[slug]/page.tsx - Control lesson → Control content loader: loads and compiles
app/controls/[slug]/page.tsx - Control lesson → MDX headings: builds outline
app/controls/[slug]/page.tsx - Control lesson → Documentation layout: uses layout
app/controls/[slug]/page.tsx - Control lesson → Breadcrumb navigation: renders trail
app/controls/[slug]/page.tsx - Control content loader → Content validation: validates frontmatter
lib/content/loader.ts - Control content loader → ASVS configuration: validates standard data
- Chapter catalog → Content types: uses types
content/categories.ts - Section catalog → Content types: uses types
content/sections.ts - Search page → Search index: builds index
app/search/page.tsx - Search page → Search results UI: renders search UI
app/search/page.tsx - Search index → Control content loader: indexes controls
lib/search.ts - Search index → Markdown text: extracts body text
lib/search.ts - Search results UI → Search index: filters entries
components/search-client.tsx - Site shell → Structured data: emits site data
app/layout.tsx - Site shell → Site metadata: sets metadata
app/layout.tsx - Structured data → Site metadata: resolves URLs
lib/structured-data.ts - Site metadata → ASVS configuration: reads identity
lib/site-config.ts