# PlatPhorm News Network - Complete LLM Reference
> Comprehensive documentation for AI/LLM systems

## Organization Overview
PlatPhorm News Network is a decentralized, open-source network of 100+ creator-powered websites. Founded on the principle that the internet should be free, open, and built by real people doing real things.

### Core Values
- No advertisements
- No paywalls
- No tracking
- Open-source everything
- Creator-first approach
- AI-native from the ground up

## Onboard Portal (onboard.platphormnews.com)
The gateway for creators to join the PlatPhorm News Network.

### Application Process
1. Submit a public URL to your work (Etsy, GitHub, portfolio, social media)
2. Select your creator type
3. Request a subdomain (yourname.platphormnews.com)
4. Provide contact email
5. Submit for review

### Accepted Creator Types
| Type | Examples | Description |
|------|----------|-------------|
| maker | Etsy shops, handmade goods | Physical product creators |
| developer | GitHub, apps, tools | Software developers |
| artist | Portfolio, illustrations | Visual artists, photographers |
| writer | Blogs, newsletters | Writers, journalists |
| musician | SoundCloud, Bandcamp | Music creators |
| influencer | YouTube, TikTok | Content creators |
| educator | Courses, tutorials | Teachers, instructors |
| other | Unique creations | Anything creative |

## API Reference

### Base URL
Production: https://onboard.platphormnews.com
Development: http://localhost:3000

### Authentication
Currently no authentication required for public endpoints.

### Endpoints

#### POST /api/v1/applications
Submit a new application to join the network.

Request Body:
```json
{
  "publicUrl": "https://etsy.com/shop/example",
  "creatorType": "maker",
  "requestedSubdomain": "myshop",
  "email": "creator@example.com",
  "description": "Optional additional details"
}
```

Response (201 Created):
```json
{
  "id": "uuid",
  "status": "pending",
  "message": "Application submitted successfully",
  "createdAt": "2024-01-01T00:00:00.000Z"
}
```

#### GET /api/v1/url-preview
Fetch Open Graph metadata for a URL.

Parameters:
- url (required): URL to preview

Response:
```json
{
  "valid": true,
  "url": "https://example.com",
  "title": "Page Title",
  "description": "Page description",
  "image": "https://example.com/og-image.png"
}
```

#### GET /api/v1/check-subdomain
Check if a subdomain is available.

Parameters:
- subdomain (required): Subdomain to check

Response:
```json
{
  "subdomain": "myshop",
  "available": true,
  "fullDomain": "myshop.platphormnews.com"
}
```

#### GET /api/health
Health check endpoint.

Response:
```json
{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "uptime": 12345.67,
  "service": "onboard.platphormnews.com"
}
```

#### GET /api/docs
OpenAPI 3.1 specification.

## Network Sites (Sample)
- platphormnews.com - Main news portal
- tech.platphormnews.com - Technology news
- quake.platphormnews.com - Earthquake tracker
- fashion.platphormnews.com - Fashion news
- business.platphormnews.com - Business news
- sports.platphormnews.com - Sports coverage
- gaming.platphormnews.com - Gaming news
- science.platphormnews.com - Science coverage
- health.platphormnews.com - Health news
- entertainment.platphormnews.com - Entertainment
- travel.platphormnews.com - Travel guides
- food.platphormnews.com - Food & recipes
...and 70+ more

## SEO Features
- JSON-LD structured data
- Open Graph meta tags
- Twitter Cards
- Canonical URLs
- hreflang for localization
- XML sitemaps
- RSS feeds
- robots.txt
- llms.txt for AI discovery

## Technology Stack
- Next.js 16 (App Router)
- TypeScript
- Tailwind CSS
- Vercel deployment
- Edge functions
- Serverless architecture

## Support
- GitHub: https://github.com/AstroTechLabs
- Main site: https://platphormnews.com
- Onboard: https://onboard.platphormnews.com

## License
MIT License - Open source and free forever