project-structure

Map divine-web source layout and boot flow from index.html to AppRouter.

46|28|Updated Sep 8, 2025
One-click install
npx skills add https://github.com/divinevideo/divine-web --skill project-structure-divinevideo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-structure
Source: https://github.com/divinevideo/divine-web/tree/main/.agents/skills/project-structure
Command: npx skills add https://github.com/divinevideo/divine-web --skill project-structure-divinevideo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted time and confusion by showing how divine-web is organized so you can quickly locate the correct place to add, move, or modify code.

Core Features & Use Cases

  • Source-first map of the app: Explains how React, routing, hooks, contexts, utilities, types, tests, config, data, and styles are laid out under src/.
  • Clear entry-point flow: Describes how index.html leads into main.tsx, App.tsx, and AppRouter.tsx to help trace execution.
  • Practical contribution guidance: Provides file placement rules and naming conventions (components, pages, hooks, contexts, types, tests) plus build/public/docs/script locations.

Quick Start

Ask for guidance on where to add a new feature by providing what you’re trying to build, for example: “Tell me where to put a new React hook, what naming it should use, and how it should be imported using the @/ alias.”

Frequently Asked Questions about project-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize React project files to find the right component fast?▼

To organize React project files effectively, map components, pages, hooks, contexts, utilities, and types under dedicated src/ directories. This structure prevents wasted time by showing exactly where each type of code lives.

What's the best way to add a new React hook to an existing Vite project structure?▼

Adding a new React hook requires placing it in the designated hooks directory under src/ and importing it using the @/ alias configured in tsconfig paths. This maintains consistent file placement and import conventions.

How does React routing work from index.html to the AppRouter?▼

React routing flows from index.html into main.tsx, then App.tsx, and finally AppRouter.tsx. This entry-point sequence traces execution to show how the application boots and initializes routes.

Where should tests and configuration files go in a React project?▼

Tests and configuration files belong in their dedicated directories alongside the src/ structure. Following these file placement rules ensures contribution guidance aligns with existing conventions for build, public, docs, and script locations.

Does this project structure convention support contributor workflow with tsconfig paths?▼

Yes, the project structure convention supports contributor workflow by leveraging tsconfig paths for consistent @/ alias imports. This ensures file placement rules and naming conventions align across components, pages, and hooks.