Marketplace project-architecture

Name: project-architecture
Author: aiskillstore

Overview of the project's tech stack, directory structure, and architectural patterns.

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/abdulsamad94/project-architecture" ~/.claude/skills/aiskillstore-marketplace-project-architecture && rm -rf "$T"

manifest: skills/abdulsamad94/project-architecture/SKILL.md

Project Architecture & Tech Stack

Tech Stack

Framework: Next.js 15 (App Router)
Language: TypeScript
Styling: Tailwind CSS v4, CSS Modules (for specific components)
Docs/Content: Docusaurus (in
```
textbook/
```
directory)
Auth: Better Auth (
```
better-auth
```
)
Database: PostgreSQL (NeonDB)
ORM: Drizzle ORM
UI Components: Lucide React icons, Custom components

Directory Structure

```
/app
```
: Next.js App Router pages and layouts.
```
/components
```
: Reusable UI components.
- ```
/auth
```
  : Authentication related components (forms, etc.).
```
/lib
```
: Utility functions and shared logic.
- ```
auth-client.ts
```
  : Better Auth client configuration.
- ```
auth.ts
```
  : Better Auth server configuration.
```
/db
```
: Database schema and connection logic.
```
/drizzle
```
: Migrations.
```
/textbook
```
: Docusaurus instance for documentation/content.
- ```
/src
```
  : Docusaurus source files.

Key Patterns

Hybrid App: Combines a Next.js web app (marketing, auth, dashboard) with a Docusaurus documentation site.
Auth Integration: Shared authentication state between Next.js and Docusaurus via cookies/sessions (handled by
```
AuthBar
```
).
Styling: Global Tailwind styles in
```
app/globals.css
```
. Docusaurus has its own theme in
```
textbook/src/css/custom.css
```
.

Development

Run root app:
```
npm run dev:root
```
Run docs app:
```
npm run dev:docs
```
Run both:
```
npm run dev
```