From 2939dd806be080acea91b6895bd7149b18c55795 Mon Sep 17 00:00:00 2001 From: rob Date: Fri, 2 Jan 2026 01:17:25 -0400 Subject: [PATCH] Document forum feature across site MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add prominent forum CTA to community page - Add Get Help section to getting-started docs - Add forum link to footer Resources section - Update CLAUDE.md with web UI and forum architecture 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 36 +++++++++++++++++++ src/smarttools/web/docs_content.py | 9 +++++ .../web/templates/components/footer.html | 1 + .../web/templates/pages/community.html | 27 ++++++++++++++ 4 files changed, 73 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 9b47766..aaf0cc2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -78,3 +78,39 @@ providers: ``` The `mock` provider is built-in for testing without API calls. + +## Web UI & Registry + +SmartTools includes a web interface and tool registry: + +### Web Modules (`src/smarttools/web/`) + +- **app.py**: Flask app factory, registers blueprints +- **routes.py**: Main web routes (docs, tutorials, tools, etc.) +- **forum/**: Community forum blueprint + - **models.py**: Forum database schema (categories, topics, replies) + - **routes.py**: Forum routes (/forum, /forum/c/, /forum/t/) +- **filters.py**: Jinja2 filters (timeago, markdown, etc.) +- **docs_content.py**: Documentation and tutorial content + +### Registry Modules (`src/smarttools/registry/`) + +- **app.py**: Registry API (tool publishing, search, downloads) +- **db.py**: SQLite schema and queries + +### Key URLs + +- `/forum` - Community forum +- `/docs` - Documentation +- `/tutorials` - Tutorial guides +- `/tools` - Tool registry browser + +### Running the Web UI + +```bash +# Development +python -m smarttools.web.app + +# Production (example) +SMARTTOOLS_REGISTRY_DB=/path/to/db PORT=5050 python -m smarttools.web.app +``` diff --git a/src/smarttools/web/docs_content.py b/src/smarttools/web/docs_content.py index e6abb4e..5e55fd5 100644 --- a/src/smarttools/web/docs_content.py +++ b/src/smarttools/web/docs_content.py @@ -81,12 +81,21 @@ output: "{summary}"
  • Providers - Configure AI providers
  • Browse Tools - Discover community tools
    • + +

    Get Help

    +

    Stuck? Have questions? We've got you covered:

    + """, "headings": [ ("what-is-smarttools", "What is SmartTools?"), ("quick-start", "Quick Start"), ("how-it-works", "How It Works"), ("next-steps", "Next Steps"), + ("get-help", "Get Help"), ], }, diff --git a/src/smarttools/web/templates/components/footer.html b/src/smarttools/web/templates/components/footer.html index 757ebac..3511880 100644 --- a/src/smarttools/web/templates/components/footer.html +++ b/src/smarttools/web/templates/components/footer.html @@ -31,6 +31,7 @@
  • Documentation
  • Tutorials
  • Registry
    • +
  • Forum
  • Community
    • diff --git a/src/smarttools/web/templates/pages/community.html b/src/smarttools/web/templates/pages/community.html index af08198..adc0958 100644 --- a/src/smarttools/web/templates/pages/community.html +++ b/src/smarttools/web/templates/pages/community.html @@ -17,6 +17,29 @@
    + +
    + +
    +
    +
    + + + +
    +
    +

    Community Forum

    +

    Ask questions, share projects, and connect with other users

    +
    +
    + + + +
    +     +
    +
    @@ -136,6 +159,10 @@
    + + Visit Forum +