update readme

README.md

@@ -372,3 +372,6 @@ This project is currently private and proprietary.
 <div align="center">
   <strong>Built with ❤️ by the Supercode team!</strong>
 </div>
+
+
+<!-- comment for testing 1 -->

apps/docs/app/docs/page.tsx

@@ -1,5 +1,5 @@
 import { redirect } from "next/navigation"
 
 export default function DocsIndex() {
-  redirect("/docs/intro")
+  redirect("/docs/dashboard-intro")
 }

apps/docs/app/layout.tsx

@@ -3,7 +3,7 @@ import "./globals.css"
 
 export const metadata: Metadata = {
   title: "Docs | Supercode",
-  description: "Documentation for Supercode — AI coding agent for the terminal.",
+  description: "Documentation for Supercode — AI SWE agent for the terminal.",
 }
 
 export default function RootLayout({

apps/docs/content/docs/authentication.mdx

@@ -0,0 +1,58 @@
+---
+title: Authentication
+description: Setting up GitHub OAuth authentication.
+---
+
+# Authentication
+
+Supercode uses GitHub OAuth for secure authentication. This allows you to sign in with your GitHub account and access your repositories.
+
+## Sign In
+
+1. Visit [supercli.com](https://supercli.com)
+2. Click **Sign In** 
+3. You'll be redirected to GitHub for authorization
+4. Authorize the Supercode application
+5. You'll be redirected back to the dashboard
+
+## GitHub OAuth Setup
+
+### For Users
+
+The OAuth flow is handled automatically. When you sign in:
+
+1. GitHub will ask you to authorize Supercode
+2. Grant access to your GitHub account
+3. You'll be able to view and connect your repositories
+
+### Required Permissions
+
+Supercode requests the following GitHub permissions:
+- **Read user profile** - To display your account info
+- **Read repositories** - To list and display your repos
+- **Read repository contents** - To analyze code when using Terminal
+
+## Session Management
+
+- Sessions are managed via secure HTTP-only cookies
+- Session tokens are encrypted with `BETTER_AUTH_SECRET`
+- Sessions persist across browser sessions
+
+## Security
+
+- Passwords are never stored (GitHub handles authentication)
+- API keys for AI providers are stored per-user in encrypted form
+- All requests are served over HTTPS in production
+
+## Troubleshooting
+
+### Authorization Failed
+
+If GitHub authorization fails:
+1. Check that you're logged into the correct GitHub account
+2. Ensure the Supercode app hasn't been revoked in GitHub settings
+3. Try clearing browser cookies and signing in again
+
+### Session Expired
+
+Sessions expire after 30 days of inactivity. Simply sign in again to continue.

apps/docs/content/docs/dashboard-intro.mdx

@@ -0,0 +1,40 @@
+---
+title: Dashboard
+description: Overview of the Supercode Dashboard.
+---
+
+# Dashboard
+
+The Supercode Dashboard is a web-based interface for managing your account, connecting GitHub repositories, and accessing the Terminal AI coding agent.
+
+## Features
+
+- **Authentication** - Secure sign-in with GitHub OAuth
+- **Repository Management** - Connect and manage your GitHub repositories
+- **Terminal Access** - Launch the AI coding terminal for your projects
+- **Settings** - Manage your profile and connected repositories
+
+## Getting Started
+
+1. Sign in at [supercli.vercel.app](https://supercli.vercel.app) using GitHub
+2. Navigate to the **Providers** page to connect your repositories
+3. Access the **Terminal** to start AI-assisted coding
+
+## Navigation
+
+| Page | Description |
+|------|-------------|
+| Dashboard | Main overview and quick actions |
+| Providers | Connect and manage GitHub repositories |
+| Terminal | Launch the AI coding agent |
+| Settings | Profile and account management |
+
+## Tech Stack
+
+The dashboard is built with:
+- Next.js 16 (App Router)
+- React 19
+- TypeScript
+- Tailwind CSS v4
+- Better-Auth for authentication
+- Prisma with PostgreSQL