Skip to content

Conversation

@athexweb3
Copy link
Contributor

@athexweb3 athexweb3 commented Dec 14, 2025

docs: implement proper documentation website

Description

This PR introduces the official documentation website for react-native-quick-crypto.
The site is built with Next.js (App Router) and Fumadocs, providing a fast, modern, and searchable documentation experience.

Features

  • Modern stack
    Built with Next.js 14 and Fumadocs.

  • Comprehensive API reference
    Detailed documentation for all modules, including Cipher, Hmac, PBKDF2, RSA, BLAKE3, and more.

  • Practical guides
    New guides covering real-world use cases:

    • End-to-end encryption (Signal-like chat)
    • TOTP (2FA) implementation
    • Crypto wallet creation (BIP39 / HD keys)
    • Secure storage patterns (MMKV integration)
    • Large file encryption (streaming)
  • Custom UI (Nitro-style)
    Custom landing page, hero section, and responsive layout aligned with the Nitro docs design language.

  • Performance benchmarks
    Visual performance benchmarks for the library.

Notes for Reviewers

This PR is fairly large and introduces a full documentation stack along with opinionated structure, wording, and examples.

Because of that, it may include:

  • Incorrect or incomplete technical explanations
  • Opinion-based decisions around structure, naming, and UX
  • Assumptions in guides that may not align with all use cases
  • Minor content or MDX inconsistencies

A thorough review is highly appreciated, especially around:

  • API accuracy and crypto correctness
  • Guide assumptions and real-world applicability
  • Terminology, wording, and overall doc structure
  • Any missing, misleading, or unnecessary sections

Please feel free to be strict. Feedback, corrections, and suggestions are very welcome. The goal is to make these docs accurate, clear, and maintainable for the long term.

✅ Verification

  • Documentation site builds successfully (bun run build)
  • MDX content renders correctly
  • Search, navigation, and interactive components work as expected

- Fix EOF line ending in .gitignore
- Add react-native-nitro-modules to all installation instructions
- Update performance claims from '58x' to 'hundreds of times faster'
- Reframe JSI mentions to focus on Nitro Modules architecture
- Add libsodium/xsalsa20 configuration documentation
- Change Simple Random Strings to suggest react-native-get-random-values for random-only use cases
- Update comparison title from JSI to Nitro
- Add benchmark philosophy note explaining comparison context
@athexweb3 athexweb3 force-pushed the docs branch 2 times, most recently from fa2cb0b to 536d9a3 Compare December 15, 2025 03:49
@athexweb3 athexweb3 requested a review from boorad December 15, 2025 04:51
@athexweb3
Copy link
Contributor Author

added lib folder. you can check now

- Add comprehensive 'Contributing' and 'Writing Documentation' guides to the website.
- Update `CONTRIBUTING.md` with instructions for updating feature coverage.
- Update [README.md](/README.md:0:0-0:0) with links to the new documentation guides.
- Add theme-aware banner images to the Quick Start page.
- Standardize documentation structure guidelines.
- Fix broken table formatting in 'What is RNQC?' introduction page.
Copy link
Collaborator

@boorad boorad left a comment

Choose a reason for hiding this comment

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

LGTM! :shipit:

@boorad boorad merged commit e6cd40b into margelo:main Dec 16, 2025
1 check passed
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