Skip to content

Feature | Add documentation of caddy control #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 47 commits into
base: main
Choose a base branch
from

Conversation

mukezhz
Copy link
Collaborator

@mukezhz mukezhz commented Apr 29, 2025

This pull request introduces several updates to the project, including improvements to the Docker setup, content management, and documentation. Key changes include switching the Docker base image, adding new content-layer configurations, and enhancing the project's documentation with metadata, sidebar navigation, and API references.

Docker and Build System Updates:

  • Updated .dockerignore to include .contentlayer/ and docker-compose.* files for better build context management.
  • Changed the Docker base image from node:20.14.0-alpine3.20 to node:jod-bookworm-slim and added openssl installation in the build process. [1] [2]
  • Added a Makefile with a push target for building and pushing Docker images to a repository.
  • Introduced a new docker-compose.system.yml file for running the application with production settings.

Content Management Enhancements:

  • Added contentlayer.config.ts to define document types and configure MDX processing with plugins like remark-gfm and rehype-slug.
  • Created initial content files, such as button.mdx and installation.mdx, to provide a foundation for documentation. [1] [2]

Documentation Improvements:

  • Introduced a meta.tsx file to define metadata for the documentation, including SEO optimizations and OpenGraph settings.
  • Added a sidebar.tsx file to define navigation structure for the documentation, grouping pages into categories like "Getting Started" and "API Reference."
  • Created a toc.tsx file to define a table of contents for the documentation, detailing sections and pages for each topic.
  • Added comprehensive API documentation in docs/api/authentication.mdx and docs/api/endpoints.mdx, covering topics like authentication, endpoints, and best practices. [1] [2]

mukezhz and others added 30 commits April 7, 2025 19:20
- Implemented PermissionGuard component for conditional rendering based on user permissions.
- Created PermissionsManagement component for managing permissions, including creating new permissions and displaying existing ones.
- Added RolesManagement component for managing user roles, including creating and editing roles.
- Developed UserManagement component for user management, including assigning roles and resetting passwords.
- Introduced resource configuration for permissions and actions.
- Added hooks for fetching and managing roles and permissions.
- Enhanced user schema to include role and permissions.
- Implemented API client response interceptor for handling authentication errors.
- Updated auth store to include permission checking logic.
- Simplified ProtectedLayout and Home components by removing unnecessary state management and effects.
- Enhanced user profile fetching and handling in SettingsPage and other components.
- Introduced PermissionGuard component for better permission management across the application.
- Updated user management components to conditionally render actions based on user permissions.
- Improved error handling in user hooks to prevent crashes when used outside QueryClientProvider.
- Cleaned up API client error logging and auth state reset logic.
- Added permission checks for various user actions to ensure proper access control.
refactor: simplify imports in PageHeader component
…tomization docs

feat: enhance DocsLayout with new icons and update GitHub link
fix: adjust Home page content and update author information
fix: improve header styling by removing unnecessary margin
feat: add new logo assets for branding
@mukezhz mukezhz added the documentation Improvements or additions to documentation label Apr 29, 2025
@mukezhz mukezhz requested a review from Copilot April 29, 2025 11:23
@mukezhz mukezhz self-assigned this Apr 29, 2025
@mukezhz mukezhz marked this pull request as ready for review April 29, 2025 11:23
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This pull request improves the project's documentation and content management while updating the Docker configuration for running a new Caddy Control service. The key changes include:

  • Adding a new Docker Compose service for caddycontrol with production-ready settings.
  • Configuring Contentlayer with MDX support and relevant plugins.
  • Introducing new configuration files (toc.tsx, sidebar.tsx, meta.tsx) to enhance documentation navigation and metadata.

Reviewed Changes

Copilot reviewed 131 out of 146 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docker-compose.system.yml Adds a service for caddycontrol with environment settings and host networking for production.
contentlayer.config.ts Sets up Contentlayer to process MDX files with remark and rehype plugins.
config/toc.tsx Defines a table of contents structure for documentation pages.
config/sidebar.tsx Implements sidebar navigation with icon mappings for documentation.
config/meta.tsx Establishes SEO and OpenGraph metadata for the documentation site.
Files not reviewed (15)
  • .dockerignore: Language not supported
  • Dockerfile: Language not supported
  • Makefile: Language not supported
  • content/button.mdx: Language not supported
  • content/installation.mdx: Language not supported
  • docs/api/authentication.mdx: Language not supported
  • docs/api/endpoints.mdx: Language not supported
  • docs/api/overview.mdx: Language not supported
  • docs/components/button.mdx: Language not supported
  • docs/components/dialog.mdx: Language not supported
  • docs/components/folder-tree.mdx: Language not supported
  • docs/components/input.mdx: Language not supported
  • docs/components/menu.mdx: Language not supported
  • docs/components/nav-menu.mdx: Language not supported
  • docs/components/note.mdx: Language not supported

mukezhz and others added 14 commits April 30, 2025 11:37
…ce RolesManagement to display permissions for admin role
- Cleaned up import statements for better readability.
- Consolidated error handling responses in user-related API routes.
- Improved permission checks for user actions.
- Enhanced password handling in user creation and reset processes.
- Updated resource configuration to maintain consistency in naming conventions.
- Refined error handling utilities for better clarity and maintainability.
- Adjusted hooks for user and key management to streamline API interactions.
- Ensured consistent formatting and structure across various schema definitions.
- Improved overall code readability and maintainability by applying consistent formatting.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant