Skip to content

feat(website): add project website#376

Open
leseb wants to merge 1 commit into
praxis-proxy:mainfrom
leseb:leseb/project-website
Open

feat(website): add project website#376
leseb wants to merge 1 commit into
praxis-proxy:mainfrom
leseb:leseb/project-website

Conversation

@leseb
Copy link
Copy Markdown
Contributor

@leseb leseb commented May 21, 2026

Summary

Adds a Docusaurus 3 website for the Praxis project that builds and deploys directly from this repository via GitHub Actions.

  • Landing page with animated filter pipeline visualization, feature cards, and install snippet
  • Documentation restructured from flat docs/ into categories (Getting Started, Architecture, Configuration, Filters, Protocols, Security, Development) with sidebar icons and local search
  • Examples showcase with 82 YAML configs browsable by category, displayed in a popup overlay
  • Blog with editorial post styling, drop caps, and section counters
  • GitHub Actions workflow deploys to praxis.fast on push to main when website/, docs/, or examples/ change
  • Docs remain in docs/ as the single source of truth — no duplication between repo docs and website content

Fixes praxis-proxy/praxis-proxy.github.io#1

@leseb leseb requested a review from a team May 21, 2026 11:41
@praxis-bot
Copy link
Copy Markdown
Collaborator

PR too large: 24025 lines added (limit: 500). Please split into smaller PRs. Add skip/pr-hygiene label to override.

@praxis-bot praxis-bot closed this May 21, 2026
@leseb
Copy link
Copy Markdown
Contributor Author

leseb commented May 21, 2026

The large change is expected.

@leseb leseb reopened this May 21, 2026
@leseb leseb added the skip/pr-hygiene PR size and description bypass label May 21, 2026
@leseb leseb force-pushed the leseb/project-website branch 4 times, most recently from b7c1d75 to 9ab0f8d Compare May 21, 2026 13:59
@leseb
Copy link
Copy Markdown
Contributor Author

leseb commented May 21, 2026

praxis-website-demo.mov

@leseb
Copy link
Copy Markdown
Contributor Author

leseb commented May 21, 2026

I think this is a solid website: landing page, docs and blog foundation. We can iterate on some design aspects if we want later, but I went with the current logo color's scheme as a building identity block.

Copy link
Copy Markdown
Member

@shaneutt shaneutt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@shaneutt shaneutt self-assigned this May 21, 2026
@leseb
Copy link
Copy Markdown
Contributor Author

leseb commented May 26, 2026

Let's do this out of https://github.com/praxis-proxy/praxis-proxy.github.io ?

the mono repo approach is helpful in various ways:

  • single source of truth
  • no cross repo gh action flow
  • the docs lives and evolves more naturally with the code
  • one review, one merge, one doc build, the whole picture in one pr
  • easier to refer or symlinks configs from the code into the docs
  • guarantee that the doc build work in the pr, no breakage can surface after the merge

still want to go with a different repo?

@leseb leseb requested a review from shaneutt May 26, 2026 09:56
Docusaurus 3 site with landing page, documentation, examples
showcase, and blog.

The website builds and deploys directly from this repository via
GitHub Actions. Docs live in docs/ as the single source of truth.
The site is served at praxis.fast through GitHub Pages.

- Landing page with animated filter pipeline visualization
- Documentation restructured into categories with sidebar icons
- Interactive examples page with 82 YAML configs and overlay viewer
- Blog with editorial post styling
- Local search, responsive design, dark theme
- GitHub Actions workflow for automated deployment on push to main

Fixes praxis-proxy/praxis-proxy.github.io#1

Signed-off-by: Sébastien Han <seb@redhat.com>
@leseb leseb force-pushed the leseb/project-website branch from 9ab0f8d to eb823d3 Compare May 26, 2026 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip/pr-hygiene PR size and description bypass

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Spike: Praxis Website

3 participants