Skip to content

Redesign documentation site with marketing homepage#1

Merged
sripathikrishnan merged 5 commits into
mainfrom
claude/mkdocs-github-pages-miG9A
Jan 21, 2026
Merged

Redesign documentation site with marketing homepage#1
sripathikrishnan merged 5 commits into
mainfrom
claude/mkdocs-github-pages-miG9A

Conversation

@sripathikrishnan
Copy link
Copy Markdown
Contributor

Summary

  • Redesign the documentation homepage with a standalone HTML page using Tailwind CSS
  • Match Think41 branding (colors, fonts, styling)
  • Add custom CSS for MkDocs pages to maintain consistent theming
  • Add individual developer setup guide

Changes

New Homepage (docs/index.html)

  • Standalone HTML + Tailwind CSS (not MkDocs-based) for clean marketing presentation
  • Hero section with key security value props above the fold
  • Use cases: financial models, automated reports, project tracking
  • How it works steps
  • Supported apps (Sheets, Docs, Slides with status badges)
  • Security features section
  • Organization vs Individual deployment paths
  • Documentation quick links grid
  • Full footer with navigation

Theme Consistency

  • docs/stylesheets/extra.css - Think41 colors for MkDocs pages
  • Navy header/footer (#0F172A)
  • Blue primary (#2563EB)
  • Inter font family
  • Consistent styling across homepage and docs

New Documentation

  • docs/getting-started/individual-setup.md - Guide for solo developers who want to skip the server setup

Test plan

  • Visit homepage at /extrasuite/ - should show marketing page
  • Click "Get Started" or "Docs" - should navigate to MkDocs pages
  • Verify MkDocs pages have matching navy header and blue accent colors
  • Check mobile responsiveness on homepage

🤖 Generated with Claude Code

claude and others added 5 commits January 21, 2026 13:08
Create comprehensive documentation site using MkDocs Material theme:

- Homepage with feature overview and quick start guide
- Installation guides for Claude Code, Codex, Gemini CLI, Cursor,
  Claude Coworks, Windows PowerShell, and Windows WSL
- User guide covering prompting, sharing documents, and revoking access
- Skills documentation for Google Sheets (stable), Docs (alpha), and
  Slides (alpha)
- Deployment guide with Cloud Run instructions, IAM permissions, and
  operations runbook
- Skill customization guide for organizations
- Security documentation explaining the trust model
- FAQ, privacy policy, and terms of service

Technical setup:
- GitHub Actions workflow for automatic deployment to GitHub Pages
- MkDocs Material theme with dark/light mode support
- Code syntax highlighting and copy buttons
- Navigation tabs and search functionality
- Admonition blocks for notes and warnings

Existing internal docs moved to docs/internal/ subfolder.
- Move mkdocs.yml into docs/ folder
- Add pyproject.toml for uv dependency management
- Update GitHub Actions workflow to use uv
- Remove requirements.txt (replaced by pyproject.toml)
- Add .gitignore for build artifacts
- Create website/ folder containing all documentation assets
- Move docs/, mkdocs.yml, pyproject.toml into website/
- Update GitHub Actions workflow to build from website/
- Use uv for dependency management

To test locally:
  cd website && uv run mkdocs serve
- Replace MkDocs-based index.md with standalone index.html using Tailwind CSS
- Create marketing-focused homepage with Think41 brand colors and styling
- Add custom extra.css for MkDocs pages to match Think41 theme
- Add individual-setup.md guide for solo developers
- Update mkdocs.yml navigation and theme configuration

Homepage features:
- Hero section with security value props above the fold
- Use cases section (financial models, automated reports, project tracking)
- How it works steps
- Supported apps (Sheets, Docs, Slides)
- Security features section
- Organization vs Individual deployment paths
- Documentation quick links

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Delete legal/privacy.md and legal/terms.md
- Delete customization/skill-customization.md
- Remove Legal and Customization from mkdocs.yml nav
- Remove Legal column from homepage footer
- Remove Customization link from homepage documentation grid
- Update all cross-references in security.md, faq.md, skills/*.md, and individual-setup.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@sripathikrishnan sripathikrishnan merged commit f683790 into main Jan 21, 2026
1 check passed
@sripathikrishnan sripathikrishnan deleted the claude/mkdocs-github-pages-miG9A branch January 21, 2026 08:15
sripathikrishnan pushed a commit that referenced this pull request Feb 16, 2026
Pull side:
- Add missing paragraph property extractors to style_factorizer.py:
  keepTogether, keepNext, avoidWidow, direction, bgColor, borders
- Extract _PARA_PROP_TO_ATTR mapping to module-level with all 16 properties
- Refactor _build_paragraph_attrs() for reuse across paragraphs and list items
- Add paragraph property extraction to _convert_list_item()

Push side:
- Complete style_to_para_mapping in content.py with indentFirstLine→indentFirst
- Expand text_style_props set with smallcaps, superscript, subscript, link

Tests: 62 new tests covering extractors, XML attrs, style reset, class
resolution, multi-paragraph isolation, style converter, and end-to-end
reconciliation via DiffEngine.

Addresses gaps.md Bug #1 (paragraph styles bleed) and Bug #10 (indentFirstLine).

https://claude.ai/code/session_01HVFLUUwSugDnDwiGM9E7F5
sripathikrishnan added a commit that referenced this pull request Feb 27, 2026
Security:
- Move session_token from POST body to Authorization: Bearer header to prevent
  proxy/access log exposure (#1)
- Atomic ownership check in revoke_session_token via expected_email param,
  eliminating TOCTOU race (#2)
- Redact full session_hash from list_sessions when admin views another user's
  sessions; self-service callers retain it (#3)
- Fix X-Forwarded-For to use rightmost (infra-injected) IP instead of
  first (spoofable) entry (#7)

Correctness:
- Ensure service account is provisioned at session establishment time
  (exchange_auth_code_for_session), enforcing the invariant that SA always
  exists for any v2 session; remove downstream or-"" fallbacks and 500 guard (#6)
- Validate _server_base_url before opening browser to avoid post-auth failure
  when server URL is not configured (#4)
- Raise ValueError instead of silently dropping extra scopes in v2
  get_oauth_token (#5)
- Apply SA_TOKEN_CACHE_SECONDS cap client-side for SA tokens (#8)

UX:
- Prompt for confirmation before revoking an existing valid session in
  auth login; skip prompt when stdin is not a tty (#9)
- Use timezone.utc in all datetime.fromtimestamp calls in CLI output (#10)

Fakes / tests:
- Fix FakeDatabase.retrieve_auth_code to check flow_type and expiry before
  popping, preventing silent code destruction on type mismatch (#11)
- Update FakeDatabase.revoke_session_token to accept expected_email (#2)

Docs:
- Fix stale pseudo_scope field name in database.py docstring (#12)
- Document _explicit_auth_urls v2 activation edge case (#13)
- Add type safety / None discipline principle to CLAUDE.md files

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants