Develop · Official documentation

Development guides

The official website is a Next.js application separate from the blockchain infrastructure. This guide describes its structure and the rules for future changes.

Technology stack and structure

The website uses Next.js with the App Router, React, TypeScript, and Bootstrap 5, complemented by BI3LYX-specific styles. Editorial pages are generated from typed repository data.

app/
Routes, layouts, metadata, sitemap, RSS feed, and status endpoint.
components/
Reusable interface components, including navigation, cards, and the explorer.
lib/
Typed editorial data, website configuration, and models for the planned API.
tests/
Content, navigation, component, and page-rendering tests.

Local commands

  • npm install — install dependencies.
  • npm run dev — start the development server.
  • npm run typecheck — check TypeScript without emitting files.
  • npm run lint — analyze code with ESLint.
  • npm test — run the test suite.
  • npm run build — create a production build.
  • npm start — start the Next.js build.

Publishing content

Documentation pages and news are defined using typed blocks. Every new post must include a unique slug, title, description, date, and body without unconfirmed information.

  • Check internal links and metadata.
  • Clearly identify information in preparation.
  • Never publish fabricated statistics or simulated screenshots.
  • Have technical claims reviewed before publication.

API integration rules

  • Keep the server access layer separate from display components.
  • Configure the API URL only through an environment variable.
  • Provide a timeout and an explicit error state.
  • Validate response schemas before display.
  • Never expose an RPC URL, a secret, or wallet data.

Contribution and validation

  • Do not modify production infrastructure directly from the website repository.
  • Every change must pass typechecking, lint, tests, and build.
  • Commits and deployments require authorization from the project owner.
  • Binaries are never published from the website without verification and signatures.