Transform your content into social promotions with AI — Copy, paste, post. No OAuth, no complexity.
Features • Quick Start • Tech Stack • Philosophy • Roadmap
Navam Marketer is a marketing automation tool built for bootstrapped startup founders who need to maintain a social media presence without a marketing team. It uses AI to transform existing content into platform-optimized posts, with a simple copy-paste workflow that works with any social platform.
|
No marketing team? No problem. Automate content repurposing with AI while maintaining complete control over what gets published. |
Minimum Lovable Product — not just viable, but delightful. Beautiful UI, smooth UX, and thoughtful details from day one. |
|
Review and edit everything before publishing. AI generates, you approve. No auto-posting means no surprises. |
Runs completely offline with SQLite. No OAuth, no external dependencies (except Claude for content generation). Your data stays local. |
v1.0.0 Highlight: We've removed LinkedIn OAuth and auto-posting in favor of a simpler, more reliable copy-paste workflow. See What's New below.
graph LR
A[📄 Ingest URL] --> B[🤖 Generate with AI]
B --> C[📋 Copy Content]
C --> D[📱 Paste to Platform]
D --> E[🔗 Track URL]
E --> F[📊 Record Metrics]
style A fill:#3b82f6
style B fill:#8b5cf6
style C fill:#10b981
style D fill:#f59e0b
style E fill:#ef4444
style F fill:#06b6d4
🔗 Source Ingestion v0.1.0
Extract clean, readable content from any URL with a single click.
- Intelligent Parsing — Powered by Mozilla Readability
- Clean Output — Removes ads, clutter, and navigation
- Database Storage — Saved for future campaign use
- Source Management — Dedicated page to view and manage all sources
- Multi-Source Support — Generate from any saved source
Example: Paste a Medium article URL, get clean markdown content ready for AI processing.
🤖 AI Content Generation v0.3.0
Generate platform-optimized posts with Claude AI (Sonnet 4.5).
Multi-Platform Generation
- 📱 LinkedIn: Professional posts (3000 chars, 3-5 hashtags)
- 🐦 Twitter: Punchy tweets (280 chars, 1-2 hashtags)
- 📝 Blog: Introduction paragraphs (500 chars)
Customization Options
- Tone Selection: Professional, Casual, Technical, Enthusiastic
- Call-to-Action: Optional CTA for driving engagement
- Source-Based: Generate from ingested content
Features
- Batch generation for all platforms at once
- Preview before saving to kanban
- Tasks created in Draft status for review
- Powered by Claude Sonnet 4.5 via Anthropic SDK
📋 Campaign & Task Management v0.2.0
Organize your social media workflow with an intuitive Kanban board.
Campaign Management
- Create unlimited campaigns with names and descriptions
- Track task counts per campaign
- Archive/restore campaigns for organization
- Export/import campaigns as JSON
- Duplicate campaigns with one click
Kanban Board
- 🗂️ 4 Status Columns: To Do → Draft → Scheduled → Posted
- 🖱️ Drag & Drop: Smooth task movement with visual feedback
- ✏️ Inline Editing: Edit post content directly on cards
- 🏷️ Platform Tags: LinkedIn, Twitter, Blog with color coding
- 🔄 Real-Time Updates: Instant sync with database
Task Features
- Platform-specific categorization
- Scheduled date tracking (for planning, not auto-posting)
- Delete with confirmation
- Content preview with line clamping
📋 Manual Copy-Paste Workflow v1.0.0 🆕
Simple, reliable workflow that works with any social platform — no OAuth required.
Copy to Clipboard
- 📋 One-Click Copy — Copy button on every task card
- ✅ Toast Confirmation — "Post content copied to clipboard!"
- 🎯 Works Everywhere — LinkedIn, Twitter, Facebook, Instagram, Threads, etc.
Manual Post URL Tracking
- 🔗 Add URL — Link icon on posted tasks opens URL input
- 💾 Save & Display — Published URLs saved and shown as "View Post" link
- 🌐 Platform Agnostic — Works with any social platform URL
- 📊 Optional — Track URLs for reference, or skip if not needed
Benefits
- ✅ No OAuth setup or token management
- ✅ No API rate limits or failures
- ✅ Works with platforms beyond LinkedIn/Twitter
- ✅ Review post on platform before publishing
- ✅ Platform updates won't break your workflow
- ✅ Better privacy — no stored credentials
Workflow Example
1. Generate content with AI
2. Click copy button on task card
3. Open LinkedIn/Twitter/etc.
4. Paste content (Cmd+V / Ctrl+V)
5. Edit and publish manually
6. (Optional) Copy post URL and add to task
7. (Optional) Record engagement metrics
📊 Performance Dashboard v0.6.0
Track your social media engagement with real-time metrics and beautiful visualizations.
KPI Cards
- 📊 Total Posts: Count of published content
- 👆 Total Clicks: Link clicks via tracking
- ❤️ Total Likes: Engagement metrics
- 🔄 Total Shares: Content sharing stats
Engagement Chart
- 📈 Line chart showing metrics over last 30 days
- Multiple data series (clicks, likes, shares)
- Interactive tooltips and legend
- Responsive design for all screen sizes
Manual Metric Recording v0.7.3
- 📊 Record Metrics Dialog: Click-to-open interface on posted tasks
- ⚡ Quick Actions: One-click +1 buttons for likes, shares, comments, clicks
- 📝 Custom Entry: Form for bulk metric recording
- 🎨 Visual Display: Color-coded badges with icons on kanban cards
- 🔄 Real-Time Updates: Metrics refresh automatically after recording
Link Click Tracking
- Redirect tracker:
/r/{taskId}?url={destination} - Automatic click recording
- Real-time dashboard updates
- Easy integration in social posts
🎯 Additional Features (Click to expand)
- Unified Navigation
v0.7.2— Breadcrumb trail, active states, workflow clarity - Onboarding Hints
v0.11.1— Dismissible, contextual guidance for first-time users - Empty States
v0.11.0— Actionable prompts when campaigns/sources are empty - Toast Notifications
v0.10.0— Elegant feedback with Sonner
- Campaign Archive
v0.11.2— Archive/restore campaigns, soft delete - Export/Import
v0.12.1— JSON export/import for backup and portability - Campaign Duplication
v0.12.2— One-click campaign copying with intelligent task reset - Database Migrations
v0.12.0— Version-controlled schema with Prisma Migrate
- 279 Tests — 100% passing, comprehensive integration & component tests
- TypeScript — Full type safety across the entire codebase
- API Routes — RESTful conventions, clean architecture
- Hot Reload — Fast development with Next.js 15
Major Release: This is a breaking change that removes OAuth complexity and embraces simplicity.
- 📋 Copy Button — One-click clipboard copy on all task cards
- 🔗 Manual URL Tracking — Add published post URLs for reference
- 🌐 Platform Agnostic — Works with ANY social platform, not just LinkedIn
- 🎯 Simplified Workflow — No auth, no scheduler, no complexity
- 🔐 LinkedIn OAuth — No more token management or refresh logic
- ⏰ Auto-Posting — No automatic posting to social platforms
- 🗄️ User Model — No OAuth credential storage
- 📅 Scheduler — No background job processing
Before v1.0.0:
Configure OAuth → Connect LinkedIn → Schedule → Auto-post → Hope it works
After v1.0.0:
Copy → Paste → Post → Done ✨
Why This Change?
- Simpler: No OAuth setup, no token errors, no API failures
- More Reliable: Platform updates won't break functionality
- Better Privacy: No credentials stored, no external dependencies
- Platform Flexible: Works with LinkedIn, Twitter, Facebook, Instagram, Threads, etc.
- Local-First: True offline capability (except AI generation)
📖 See
backlog/release-1.0.0.mdfor complete details and migration guide.
- Node.js 18 or higher
- npm (or pnpm)
- Anthropic API Key (for AI content generation)
# Clone the repository
git clone https://github.com/yourusername/navam-marketer.git
cd navam-marketer
# Install dependencies (use --legacy-peer-deps for React 19 RC)
npm install --legacy-peer-deps
# Set up environment variables
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY
# Set up the database (run migrations)
npm run db:push
# Start the development server
npm run dev🎉 That's it! Open http://localhost:3000 to get started.
Supported URLs:
|
|
|
|
|
|
|
|
┌─────────────────────────────────────────────────────────────┐
│ Next.js 15 App Router │
│ (React 19 RC) │
├─────────────────────────────────────────────────────────────┤
│ Frontend │ Backend │
│ ├─ shadcn/ui + Radix UI │ ├─ API Routes (RESTful) │
│ ├─ Tailwind CSS │ ├─ Prisma ORM │
│ ├─ @dnd-kit (Drag & Drop) │ ├─ SQLite (dev) │
│ ├─ Recharts (Viz) │ ├─ PostgreSQL (prod) │
│ ├─ Zustand (UI State) │ └─ Claude AI Integration │
│ └─ TanStack Query (Future) │ │
└─────────────────────────────────────────────────────────────┘
marketer/
├── 📁 app/ # Next.js App Router
│ ├── 📁 api/ # Backend API routes
│ │ ├── 📁 campaigns/ # Campaign CRUD + archive/export/import
│ │ ├── 📁 tasks/ # Task CRUD
│ │ ├── 📁 source/ # Content extraction
│ │ ├── 📁 generate/ # AI content generation
│ │ └── 📁 metrics/ # Performance tracking
│ ├── 📁 campaigns/ # Campaign management page
│ ├── 📁 sources/ # Source management page
│ ├── 📄 layout.tsx # Root layout with navigation
│ ├── 📄 page.tsx # Home page
│ └── 📄 globals.css # Global styles + Tailwind
│
├── 📁 components/ # React components
│ ├── 📁 ui/ # shadcn/ui primitives (Button, Dialog, etc.)
│ ├── 📄 kanban-board.tsx # Drag-drop board container
│ ├── 📄 kanban-column.tsx # Column (To Do, Draft, etc.)
│ ├── 📄 kanban-card.tsx # Task card with copy/edit/delete
│ ├── 📄 navigation.tsx # Unified navigation header
│ ├── 📄 dashboard-stats.tsx # KPI cards
│ ├── 📄 engagement-chart.tsx # Recharts visualization
│ ├── 📄 create-campaign-dialog.tsx
│ ├── 📄 create-task-dialog.tsx
│ ├── 📄 generate-content-dialog.tsx
│ ├── 📄 schedule-task-dialog.tsx
│ ├── 📄 record-metrics-dialog.tsx
│ ├── 📄 add-source-dialog.tsx
│ ├── 📄 source-card.tsx
│ ├── 📄 source-details-dialog.tsx
│ └── 📄 onboarding-hint.tsx
│
├── 📁 lib/ # Utilities & helpers
│ ├── 📄 prisma.ts # Database client singleton
│ ├── 📄 store.ts # Zustand state management
│ ├── 📄 utils.ts # Helper functions (cn, etc.)
│ ├── 📄 onboarding.ts # Hint dismissal persistence
│ └── 📄 test-utils.ts # Test helpers
│
├── 📁 prisma/ # Database
│ ├── 📄 schema.prisma # Schema definition
│ ├── 📁 migrations/ # Migration history
│ └── 📄 dev.db # SQLite database (local)
│
├── 📁 __tests__/ # Test suite
│ ├── 📁 integration/ # Integration tests (279 tests)
│ └── 📁 components/ # Component tests
│
├── 📁 backlog/ # Project planning
│ ├── 📄 active.md # Development roadmap
│ ├── 📄 issues.md # Issue tracking
│ └── 📄 release-*.md # Release notes (v0.1.0 - v1.0.0)
│
├── 📄 CLAUDE.md # AI assistant instructions
├── 📄 README.md # This file
├── 📄 package.json # Dependencies & scripts
├── 📄 tsconfig.json # TypeScript config
├── 📄 tailwind.config.ts # Tailwind config
├── 📄 next.config.mjs # Next.js config
└── 📄 .env.example # Environment variables template
| Command | Description |
|---|---|
npm run dev |
Start development server on localhost:3000 |
npm run build |
Build optimized production bundle |
npm start |
Start production server |
npm run lint |
Run ESLint for code quality |
| Command | Description |
|---|---|
npm test |
Run all 279 tests |
npm run test:watch |
Run tests in watch mode |
npm run test:coverage |
Generate test coverage report |
| Command | Description |
|---|---|
npm run db:push |
Push schema changes (development) |
npm run db:generate |
Regenerate Prisma client |
npm run db:migrate |
Create & apply migration |
npm run db:migrate:deploy |
Apply migrations (production/CI) |
npm run db:migrate:reset |
Reset database & reapply all migrations |
npm run db:studio |
Open Prisma Studio GUI |
📖 For migration workflow details, see
docs/migrations.md
We're not building an MVP — we're building an MLP:
|
Beautiful UI and smooth UX from day one, not an afterthought. |
Review before publish, always. AI generates, you approve. |
Do less, but do it exceptionally well. Quality over features. |
Works offline, deploys globally. Your data stays yours. |
- Progressive Disclosure — Show what matters, hide complexity until needed
- Instant Feedback — Loading states, error messages, toast confirmations
- Type Safety — Full TypeScript coverage for reliability
- Component Reusability — DRY with shadcn/ui primitives
- Simplicity Over Automation — Manual control beats complex automation
"Perfection is achieved, not when there is nothing more to add, but when there is nothing left to take away." — Antoine de Saint-Exupéry
We removed OAuth, auto-posting, and scheduling because:
- Complexity ≠ Value — Simple workflows are more reliable
- Control > Convenience — Manual posting gives you control
- Privacy Matters — No credentials stored = better security
- Platform Agnostic — Works with ANY social platform
View All 18 Releases (v0.1.0 - v1.0.0)
- v0.1.0 — Source Ingestion (Mozilla Readability)
- v0.2.0 — Campaign & Task Management (Kanban)
- v0.3.0 — Content Generation with Claude AI
- v0.4.0 — Scheduling Interface
- v0.5.0 — Smooth Drag-and-Drop Animations
- v0.6.0 — Performance Dashboard & Analytics
- v0.7.0 — Unified Campaign Manager
- v0.7.1 — Source Management Page
- v0.7.2 — Unified Navigation System
- v0.7.3 — Manual Metrics Recording UI
- v0.8.0 — Streamlined Navigation & Source Management
- v0.8.1 — Fix Add Source Button Bug
- v0.9.0 — Streamlined Generate from Source Workflow
- v0.10.0 — Enhanced Source Fetch UX (Toast Notifications)
- v0.11.0 — Improved Campaign Workflow Clarity
- v0.11.1 — Dismissible Onboarding Hints
- v0.11.2 — Campaign Archive Management
- v0.12.0 — Database Migrations Setup
- v0.12.1 — Data Export/Import
- v0.12.2 — Campaign Duplication
- v0.13.0 — LinkedIn API Integration (removed in v1.0.0)
- v0.13.1 — LinkedIn OAuth Configuration Fix (removed in v1.0.0)
- v0.14.0 — User-Owned LinkedIn OAuth Credentials (removed in v1.0.0)
- v0.14.1 — LinkedIn Token Auto-Refresh (removed in v1.0.0)
- v1.0.0 — Manual Copy-Paste Workflow (MAJOR RELEASE)
Goal: Track engagement metrics without requiring OAuth authentication.
Planned Features:
- CSV/JSON import for bulk metrics
- Metrics import from platform analytics exports
- Optional browser extension for auto-tracking
- Improved manual metrics entry workflow
See: Issue #9 in backlog/issues.md
Goal: Intelligent AI orchestration with model routing.
Planned Features:
- LangGraph workflow implementation
- Model routing (Claude Haiku for speed, Sonnet for quality)
- Agent decision logging
- Stream progress updates to UI
Status: Planning stage
📖 See
backlog/active.mdfor detailed specifications.
Test Suite: 279 tests, 100% passing
# Run all tests
npm test
# Watch mode for development
npm run test:watch
# Generate coverage report
npm run test:coverage- Integration Tests: 18 test files covering all API routes and workflows
- Component Tests: UI component functionality and accessibility
- Manual Posting Workflow: 17 comprehensive tests for copy-paste workflow
- Database Operations: Real Prisma client, actual SQLite database
- Execution Time: < 3 seconds for full suite
Philosophy: Integration over unit tests. Test real database operations, not mocks.
| Metric | Count |
|---|---|
| Total Releases | 18 |
| API Routes | 11 |
| React Components | 26 |
| Database Models | 4 |
| Test Files | 18 |
| Tests Passing | 279 (100%) |
| Lines of Code | ~11,800 |
| Dependencies | Production-ready stack |
This is currently a private project. For questions or feedback, please contact the development team.
If you're working on this codebase:
- Read
CLAUDE.mdfor AI assistant instructions - Follow the MLP philosophy and design principles
- Write tests for all new features (integration tests preferred)
- Update
backlog/active.mdwith progress - Create release notes in
backlog/release-X.Y.Z.md
Private — All rights reserved.
Built with modern tools from the open-source community:
|
Next.js The React Framework |
shadcn/ui Beautiful components |
Prisma Next-gen ORM |
dnd-kit Modern drag & drop |
Tailwind CSS Utility-first CSS |
Zustand State management |
Special Thanks:
- Anthropic — Claude AI for content generation
- Mozilla — Readability for content extraction
- Vercel — Hosting and deployment platform
- The entire open-source community
Need Help?
📖 Check backlog/active.md for development roadmap
📝 Review CLAUDE.md for project guidelines
🐛 Found a bug? Check backlog/issues.md
v1.0.0 — Made with ❤️ for bootstrapped founders
"Simplicity is the ultimate sophistication."
