Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as opaque submodule gitlinks on GitHub) into fully-tracked first-party content. AITM now merges its 7 vendored repos as first-party engines: - memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts - git: vendored C git (bundled binary) + gitnexus (in-process code intelligence) - agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess) Includes the full session's product build: Gitgram web/mobile/backend features, AITM website/CLI/MCP, the unified memory layer, engine build tooling (scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md), and extensive test suites. Build artifacts, node_modules, external/, and gemini-cli are gitignored. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.3 KiB
4.3 KiB
Gitgram Web - Fixes and Implementation Plan
✅ COMPLETED FIXES
1. Landing Page Layout (FIXED)
- Issue: Content was left-aligned instead of centered
- Fix:
- Updated
ConditionalLayoutto handle landing page separately - Added proper centering with
items-center justify-centeron main container - Changed all text colors to use design system variables (white, foreground-secondary)
- Updated borders and backgrounds to use design system colors
- Updated
2. GitHub OAuth Button (FIXED)
- Issue: Button didn't work, no error handling
- Fix:
- Added proper error handling for missing
NEXT_PUBLIC_GITHUB_CLIENT_ID - Added URL encoding for redirect URI
- Added user-friendly error messages
- Added try-catch for error handling
- Added proper error handling for missing
3. Global CSS Reset (FIXED)
- Issue: Default browser margins/padding causing layout issues
- Fix: Added proper CSS reset for html, body, and all elements
4. Auth Pages Centering (FIXED)
- Issue: Login/Register pages not centered
- Fix: Updated
ConditionalLayoutto properly center auth pages
🔧 IMPLEMENTATION PLAN
Phase 1: Environment Setup (REQUIRED)
-
Create
.env.localfile inweb/directory:NEXT_PUBLIC_GITHUB_CLIENT_ID=your_github_client_id_here NEXT_PUBLIC_API_URL=http://localhost:4000/api -
Get GitHub OAuth Credentials:
- Go to GitHub Settings > Developer settings > OAuth Apps
- Create new OAuth App
- Set Authorization callback URL:
http://localhost:3000/auth/github/callback - Copy Client ID to
.env.local
Phase 2: Backend API Verification
-
Verify Backend Endpoints:
/api/v1/auth/github- GitHub OAuth callback handler/api/v1/auth/login- Email/password login/api/v1/auth/register- User registration- All endpoints should return proper JSON responses
-
Test API Connection:
- Ensure backend is running on port 4000 (or update
NEXT_PUBLIC_API_URL) - Test with Postman/curl to verify endpoints work
- Ensure backend is running on port 4000 (or update
Phase 3: Frontend Functionality
-
Authentication Flow:
- ✅ GitHub OAuth button (with error handling)
- ✅ Email/password login
- ✅ User registration
- ✅ Token storage in Zustand store
- ✅ Protected routes
-
Page Layouts:
- ✅ Landing page (centered, proper styling)
- ✅ Login page (centered)
- ✅ Register page (centered)
- ✅ Feed page (with sidebar)
- ✅ Profile pages
- ✅ All other pages
Phase 4: Testing Checklist
- Landing page displays centered
- "Connect with GitHub" button works (redirects to GitHub)
- GitHub OAuth callback works (redirects back and logs in)
- Login form works
- Register form works
- All pages are properly centered
- Navigation works
- Protected routes redirect to login if not authenticated
🐛 KNOWN ISSUES TO FIX
1. Environment Variables
- Problem:
NEXT_PUBLIC_GITHUB_CLIENT_IDmight not be set - Solution: Create
.env.localfile (see Phase 1)
2. Backend Connection
- Problem: API might not be running or URL incorrect
- Solution: Verify
NEXT_PUBLIC_API_URLin.env.local
3. GitHub OAuth Callback
- Problem: Callback URL must match GitHub OAuth app settings
- Solution: Ensure callback URL in GitHub matches:
http://localhost:3000/auth/github/callback
📝 NEXT STEPS
- Set up environment variables (
.env.local) - Start backend server (if not running)
- Test GitHub OAuth flow end-to-end
- Verify all pages load correctly
- Test authentication flows
🎨 Design System Consistency
All pages now use:
- Colors: Design system variables (primary, background-dark, surface, etc.)
- Typography: Space Grotesk font
- Spacing: Consistent padding and margins
- Layout: Centered content with max-width constraints
- Components: Reusable UI components from
components/ui/
⚠️ IMPORTANT NOTES
-
GitHub OAuth requires:
- GitHub OAuth App created
- Client ID in environment variables
- Backend endpoint
/api/v1/auth/githubworking
-
All functionality is REAL, not mocked:
- Authentication uses real API calls
- All services connect to backend
- Error handling in place
-
If something doesn't work:
- Check browser console for errors
- Verify environment variables are set
- Ensure backend is running
- Check network tab for API calls