feat: Introduce FastAPI backend with API type generation setup and update project configuration.

Author: cliff-de-tech

.gitignore

@@ -137,3 +137,8 @@ logs/
 # GENERATED FILES
 # ========================================
 last_generated_post.txt
+
+# Shared contracts (auto-generated from OpenAPI)
+shared/contracts/*.ts
+shared/contracts/*.json
+!shared/contracts/README.md

README.md

@@ -211,6 +211,31 @@ cd web && npm run dev
 
 Open [http://localhost:3000](http://localhost:3000) to access the dashboard.
 
+### API Documentation
+
+The FastAPI backend provides OpenAPI documentation at stable URLs:
+
+| Endpoint | Description |
+|----------|-------------|
+| `/openapi.json` | OpenAPI 3.0 specification (JSON) |
+| `/docs` | Interactive Swagger UI documentation |
+| `/redoc` | ReDoc alternative documentation |
+
+**Local development:**
+- OpenAPI spec: [http://localhost:8000/openapi.json](http://localhost:8000/openapi.json)
+- Swagger UI: [http://localhost:8000/docs](http://localhost:8000/docs)
+- ReDoc: [http://localhost:8000/redoc](http://localhost:8000/redoc)
+
+**Production:** The same endpoints are available at your deployed backend URL.
+
+```bash
+# Download OpenAPI spec for code generation
+curl http://localhost:8000/openapi.json > openapi.json
+
+# Or in production
+curl https://your-backend.railway.app/openapi.json > openapi.json
+```
+
 ---
 
 ## Project Structure

backend/app.py

@@ -137,7 +137,35 @@
     api_limiter = None
     RateLimitExceededError = Exception
 
-app = FastAPI(title="LinkedIn Post Bot API")
+app = FastAPI(
+    title="LinkedIn Post Bot API",
+    description="""
+    AI-powered LinkedIn content automation API.
+    
+    ## Features
+    - Generate LinkedIn posts from GitHub activity
+    - Multiple AI writing templates (Standard, Build in Public, Thought Leadership, Job Search)
+    - Post history and analytics
+    - Image selection from Unsplash
+    - Scheduled posting
+    
+    ## OpenAPI Documentation
+    - OpenAPI JSON: `/openapi.json`
+    - Interactive Docs (Swagger): `/docs`  
+    - ReDoc: `/redoc`
+    """,
+    version="1.0.0",
+    openapi_url="/openapi.json",  # Explicit stable URL for OpenAPI spec
+    docs_url="/docs",  # Swagger UI
+    redoc_url="/redoc",  # ReDoc alternative
+    contact={
+        "name": "LinkedIn Post Bot",
+        "url": "https://github.com/cliff-de-tech/Linkedin-Post-Bot",
+    },
+    license_info={
+        "name": "MIT",
+    },
+)
 
 # Initialize databases
 if init_db:

package.json

@@ -0,0 +1,31 @@
+{
+    "name": "linkedin-post-bot",
+    "version": "1.0.0",
+    "description": "AI-powered LinkedIn content automation from GitHub activity",
+    "private": true,
+    "scripts": {
+        "dev": "cd web && npm run dev",
+        "build": "cd web && npm run build",
+        "start": "cd web && npm run start",
+        "lint": "cd web && npm run lint",
+        "backend": "cd backend && python app.py",
+        "generate:types": "curl -s http://localhost:8000/openapi.json > shared/contracts/openapi.json && npx openapi-typescript shared/contracts/openapi.json -o shared/contracts/api.ts",
+        "postinstall": "echo 'Run npm run generate:types after starting backend to generate API types'"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/cliff-de-tech/Linkedin-Post-Bot.git"
+    },
+    "keywords": [
+        "linkedin",
+        "automation",
+        "github",
+        "ai",
+        "content-generation"
+    ],
+    "author": "Clifford Opoku-Sarkodie",
+    "license": "MIT",
+    "devDependencies": {
+        "openapi-typescript": "^7.0.0"
+    }
+}

shared/contracts/README.md

@@ -0,0 +1,47 @@
+# Shared API Contracts
+
+This directory contains TypeScript types auto-generated from the FastAPI OpenAPI specification.
+
+## Purpose
+
+- **Type Safety**: Ensures frontend API calls match backend schemas
+- **Auto-generated**: Types are generated from `/openapi.json`
+- **Single Source of Truth**: Backend schemas define the contract
+
+## Regenerating Types
+
+Run the generation script from the project root:
+
+```bash
+npm run generate:types
+```
+
+Or manually:
+
+```bash
+# Ensure backend is running
+curl http://localhost:8000/openapi.json > shared/contracts/openapi.json
+
+# Generate TypeScript types (requires openapi-typescript)
+npx openapi-typescript shared/contracts/openapi.json -o shared/contracts/api.ts
+```
+
+## Usage
+
+```typescript
+import type { paths, components } from '@/shared/contracts/api';
+
+// Use generated types
+type Post = components['schemas']['SavePostRequest'];
+type GenerateResponse = paths['/api/post/generate-batch']['post']['responses']['200'];
+```
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `api.ts` | Generated TypeScript types (do not edit manually) |
+| `openapi.json` | Cached OpenAPI spec (auto-updated) |
+| `README.md` | This file |
+
+> ⚠️ Files in this directory (except README.md) are auto-generated. Do not edit manually.