inkonchain/docs

This repository contains the official documentation website for InkChain, a blockchain project. The repository is not the blockchain software itself, it is the documentation platform that explains how InkChain works, how to integrate with it, and how to use its tools. The problem it solves is making technical blockchain documentation accessible to developers and users through a clean, browsable web interface. The documentation site is built with Next.js (a React-based web framework) and Nextra, a library specifically designed to turn Markdown and MDX files (Markdown with embedded JavaScript components) into full documentation websites with built-in navigation, search, and theming. Content authors write documentation in MDX files, and the framework handles rendering them into web pages automatically. The Pages Router pattern is used rather than the newer App Router because of compatibility constraints at the time the project was set up. The development toolchain includes spell checking (CSpell), Markdown linting (Remark), code formatting (Prettier), and JavaScript linting (ESLint) to keep documentation accurate and consistent. Every pull request triggers an automated CI pipeline on GitHub Actions that runs all these checks and deploys a temporary preview environment via AWS Amplify, so reviewers can browse the actual live documentation before approving changes. The main branch automatically deploys to production through AWS Amplify when merged. You would interact with this repository if you are a contributor to InkChain's documentation, writing new guides, correcting errors, or updating references. You would use the live documentation site if you are a developer building on top of InkChain. The tech stack is Next.js, Nextra, Tailwind CSS, and MDX for content, hosted on AWS Amplify.