Skip to content

olgamiran/docs

This branch is 96 commits behind inkonchain/docs:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bfd448f Β· Jan 6, 2025
Dec 9, 2024
Dec 2, 2024
Dec 6, 2024
Dec 19, 2024
Jan 6, 2025
Oct 30, 2024
Oct 30, 2024
Oct 30, 2024
Oct 30, 2024
Oct 30, 2024
Nov 7, 2024
Oct 30, 2024
Oct 30, 2024
Dec 26, 2024
Dec 13, 2024
Nov 4, 2024
Jan 6, 2025
Jan 6, 2025
Oct 30, 2024
Nov 1, 2024
Dec 18, 2024
Nov 4, 2024

Repository files navigation

InkChain Documentation App

An advanced, streamlined documentation platform built with Next.js and Nextra for InkChain.

πŸš€ Build & Run

  1. Build Docker image:

    docker build -t docs .
  2. Run Docker container:

    docker run -p 3000:3000 docs

πŸ“‹ Requirements

  • Node.js: v20.11.0 or higher

πŸ“– Overview

This is a documentation application powered by Nextra and built on Next.js. Nextra simplifies the creation of documentation sites, allowing us to leverage the Pages Router for efficient navigation and routing. Currently, due to compatibility limitations, we have not yet upgraded to the App Router.

🏁 Getting Started

To get started with local development:

  1. Clone the repository
  2. Install dependencies:
    pnpm install
  3. Start development server:
    pnpm run dev

πŸ›  Tooling

Our development setup includes multiple tools to maintain high-quality code and documentation:

  • CSpell: Real-time spell checking to maintain documentation accuracy.
  • Remark: Processes and renders Markdown content with added plugins.
  • ESLint: Ensures code quality by catching potential issues.
  • Prettier: Enforces consistent code formatting.
  • Tailwind CSS: Utility-first CSS framework for fast, responsive UI development.

🚦 CI/CD Pipeline

Our CI/CD setup utilizes GitHub Actions to run automated checks on every pull request (PR):

  • js-lint: Ensures proper JavaScript code formatting with ESLint.
  • md-lint: Checks Markdown code formatting with Remark.
  • format: Enforces consistent code style with Prettier.
  • spell-check: Uses CSpell to verify correct spelling in documentation. For any unique terms (e.g., "InkChain"), add them to the ./cspell/project-words.txt file to whitelist.

🌐 Feature Branch Deployment

For every new PR, our CI/CD pipeline deploys a temporary environment via AWS Amplify. This real-time deployment enables live testing and review of changes before merging, ensuring a smoother workflow. The deployment URL is automatically provided within the PR checks, allowing team members to interact with new features.

πŸš€ Production Deployment

The main branch is configured for automatic continuous deployment via AWS Amplify. Every merge triggers a new build and deployment, ensuring that the latest version of the documentation is available to users without manual intervention.

About

Ink Documentation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • MDX 73.2%
  • TypeScript 22.6%
  • JavaScript 2.2%
  • CSS 1.8%
  • Dockerfile 0.2%