Imported from 26-1AlphaProject-eduryday/eduryday (app/AGENTS.md). Install upstream with npx skills add 26-1AlphaProject-eduryday/eduryday --skill app. Copyright stays with the author.

app/ — Next.js App Router

Parent: ../AGENTS.md

This directory contains routing only — thin wrapper route files that import from the FSD _pages/ layer and render page components.

All UI logic, state, data fetching, and business logic lives in the FSD layers:

• _pages/ — page compositions (landing, login, dashboards, course detail, IDE, etc.)
• widgets/ — independent complex UI blocks (headers, sidebars)
• shared/ui/ — reusable primitives (Button, Card, Badge, etc.)

Directory Structure

app/
├── layout.tsx                              Root layout (html, head, body)
├── globals.css                             Global styles (Tailwind)
├── page.tsx                                /
├── login/page.tsx                          /login
├── signup/page.tsx                         /signup
├── forgot-password/page.tsx                /forgot-password
├── auth/role/page.tsx                      /auth/role
├── pending/page.tsx                        /pending
├── student/
│   ├── page.tsx                            redirect → /student/dashboard
│   ├── dashboard/page.tsx                  /student/dashboard
│   ├── courses/page.tsx                    /student/courses
│   ├── courses/[id]/page.tsx               /student/courses/[id]
│   ├── ide/[id]/page.tsx                   /student/ide/[id]
│   ├── assignments/page.tsx                /student/assignments
│   ├── grades/page.tsx                     /student/grades
│   ├── my-page/page.tsx                    /student/my-page
│   └── ai-tutor/page.tsx                   /student/ai-tutor
├── professor/
│   ├── page.tsx                            redirect → /professor/dashboard
│   ├── dashboard/page.tsx                  /professor/dashboard
│   ├── courses/page.tsx                    /professor/courses
│   ├── courses/[id]/manage/page.tsx        /professor/courses/[id]/manage
│   ├── courses/[id]/grading/page.tsx       /professor/courses/[id]/grading
│   ├── courses/[id]/assignments/create/page.tsx  /professor/courses/[id]/assignments/create
│   ├── courses/create/page.tsx             /professor/courses/create
│   ├── assignments/page.tsx                /professor/assignments
│   ├── grades/page.tsx                     /professor/grades
│   ├── analytics/page.tsx                  /professor/analytics
│   └── announcements/page.tsx              /professor/announcements
├── admin/
│   ├── page.tsx                            redirect → /admin/dashboard
│   ├── dashboard/page.tsx                  /admin/dashboard
│   ├── users/page.tsx                      /admin/users
│   ├── courses/page.tsx                    /admin/courses
│   ├── logs/page.tsx                       /admin/logs
│   └── settings/page.tsx                   /admin/settings
├── auth/
│   ├── callback/route.ts                   /auth/callback (OAuth callback)
│   └── ...
└── api/                                    [see api/AGENTS.md]

Routing Table

Public Routes

Student Routes

Professor Routes

Admin Routes

Layout Files

For AI Agents

Route File Pattern

Every page.tsx file in app/ should follow this pattern:

import { PageName } from '@/_pages/page-name/ui/PageName';

export default function RouteHandler() {
  return <PageName />;
}

Or with async data fetching (using Supabase):

import { PageName } from '@/_pages/page-name/ui/PageNamePage';
import { getRouteAuthContext, getServiceRoleClient } from '@/shared/lib/supabase/route';

export default async function RouteHandler() {
  const auth = await getRouteAuthContext();
  const client = getServiceRoleClient();

  // Fetch data, pass as props to component
  const data = await fetchData(client);

  return <PageName data={data} />;
}

Rules

1. Never put UI logic in app/ — Keep route files thin wrappers only
2. Import from _pages/ not pages/ — Next.js uses pages/ for Pages Router detection; we use _pages/
3. Use async for data fetching — Leverage Next.js 15/16 Server Components
4. Auth context — Call getRouteAuthContext() and getServiceRoleClient() for protected routes
5. Error fallback — Return a component with empty state if auth fails or data is missing
6. Create FSD page first — Before adding a new route file, create the FSD page component in _pages/

Adding a New Route

1. Create the FSD page component:

   _pages/my-page/ui/MyPage.tsx
   

2. Create the route file:

   app/my-path/page.tsx
   import { MyPage } from '@/_pages/my-page/ui/MyPage';
   export default function MyRoute() { return <MyPage />; }

API Routes

API endpoints live in app/api/. See api/AGENTS.md for endpoint documentation.