https://github.com/ardriveapp/public-site
ArDrive.io public site.
https://github.com/ardriveapp/public-site
Last synced: 9 days ago
JSON representation
ArDrive.io public site.
- Host: GitHub
- URL: https://github.com/ardriveapp/public-site
- Owner: ardriveapp
- License: apache-2.0
- Created: 2026-04-07T17:24:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-07-16T22:23:38.000Z (24 days ago)
- Last Synced: 2026-07-17T00:20:35.093Z (24 days ago)
- Language: MDX
- Size: 70.7 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# ArDrive Public Site
A modern Next.js marketing site for ArDrive's decentralized data solutions, featuring MDX content and static export for GitHub Pages.
## Tech Stack
- **Framework:** Next.js 15 with App Router
- **Styling:** Tailwind CSS v4
- **Content:** MDX with TypeScript
- **Deployment:** Static export (GitHub Pages compatible)
## Quick Start
```bash
yarn install
yarn dev
```
Visit `http://localhost:3000` to see the site.
## Project Structure
```
content/ # MDX articles, case studies, use cases
public/ # Static assets and images
src/
app/ # Next.js App Router pages
components/ # React components
lib/ # Content loaders and utilities
```
## Key Sections
- **Articles** (`/articles`) — Blog posts and technical content
- **Case Studies** (`/case-studies`) — Project implementations
- **Use Cases** (`/use-cases`) — Industry applications
- **Ecosystem** (`/ecosystem`) — Partner projects
- **Cloudmap** (`/cloudmap`) — Gateway locations
- **Help** (`/help`) — Product guides, FAQs, and troubleshooting
## Agent-Friendly Help Indexes
The build generates static files for AI agents and retrieval tools from `content/help/*.mdx`:
- `/llms.txt` — concise site and help map
- `/llms-full.txt` — full public help corpus in markdown-oriented text
- `/help/index.json` — structured help article metadata
Refresh them without a full build:
```bash
yarn generate-agent-indexes
```
## Ask Arie Widget
A floating chat widget powered by AI that provides instant Q&A about ar.io products and documentation.
### Features
- **Floating Button**: Bottom-right corner floating button with message icon
- **AI-Powered Responses**: Uses external chat API
- **Threaded Conversations**: Maintains conversation context across questions (per-tab persistence)
- **New Chat**: Reset conversations and start fresh with a new thread
- **Citations**: Displays clickable citations in `[Title](url)` format with "sources used" indices
- **Mobile Responsive**: Full-screen modal on mobile, anchored panel on desktop
- **Copy to Clipboard**: Copy assistant responses with one click
- **Error Handling**: Graceful fallbacks for API failures
- **Accessibility**: ESC to close, outside click, auto-focus input
### API Integration
**Request:**
```json
POST https://sparklechat-3bzk.onrender.com/marketing/ask
{
"question": "user query string",
"thread_id": "abc123..." // Optional: reuse existing thread for conversation continuity
}
```
**Response:**
```json
{
"answer": "AI-generated response text",
"citations": ["[Title](url)", "[Another Title](url)"],
"sources_used": [1, 2],
"chunk_count": 42,
"thread_id": "abc123...", // Always present: thread identifier for conversation continuity
"message_id": "msg456...", // Always present: unique identifier for this assistant message
"parent_message_id": null // null for first turn, otherwise previous assistant message ID
}
```
### Technical Notes
- **Per-Tab Persistence**: Chat history and thread context persist across page reloads via `sessionStorage`
- **New Chat Button**: Reset conversations and start fresh (clears thread + messages)
- **Cross-Tab Isolation**: Each browser tab maintains independent conversation state
- **Static Export Safe**: No server-side features, works with GitHub Pages
- **CORS Enabled**: External API allows cross-origin requests
## Adding Content
Create MDX files in the appropriate `content/` directory with frontmatter. Images go in corresponding `public/` subdirectories. Display metadata (icons, labels, etc.) lives in `src/lib/*-config.ts` files.
> 📖 **Full Documentation**: See [AGENTS.md](AGENTS.md) for detailed content guidelines and technical specs.
## Build & Deploy
```bash
yarn build
```
Builds to static files in `/out`. Supports GitHub Pages deployment with automatic base path handling.