DevCommunity Frontend

The official frontend for DevCommunity — a Web3 developer community platform. Built with React, Vite, and TypeScript, with an Express-based SEO server for social crawlers and production serving.

Backend API: devcommunityV2-api

Documentation: docs.devcommunity.io

Features

• Fast SPA powered by Vite and React 18
• Server-side SEO rendering for posts, pages, and profiles
• Web3 wallet authentication (Cardano, Safrochain/Cosmos, and more)
• OAuth sign-in (Google, GitHub) via the API
• PWA support and push notifications
• Full-text search, filters, and rich content types (posts, hackathons, events, opportunities)
• Dark mode and responsive layout

Prerequisites

• Node.js 20+ (.nvmrc)
• npm 9+
• Running DevCommunity API for authenticated features

Quick start

git clone https://github.com/Dev-Community-IO/devcommunityIO.git
cd devcommunityIO
npm install
cp .env.example .env
# Edit .env — set VITE_API_BASE_URL to your API instance
npm run dev

• Vite dev server: http://localhost:3351 (configurable via VITE_PORT)
• SEO server: http://localhost:3352 (configurable via PORT)

Scripts

Command	Description
npm run dev	Start Vite + SEO server concurrently
npm run dev:vite	Vite dev server only
npm run build	Production build to dist/
npm run serve	Build and start production SEO server
npm run lint	ESLint
npm run typecheck	TypeScript check
npm run format	Prettier format
npm run format:check	Prettier check (CI-friendly)

Environment variables

See .env.example for all variables. Never commit .env files.

Key variables:

Variable	Description
VITE_API_BASE_URL	Backend API base URL (e.g. http://localhost:3344/api)
VITE_APP_URL	Public frontend URL
VITE_RECAPTCHA_SITE_KEY	Google reCAPTCHA site key (public)
PORT	SEO/production server port

Project structure

devcommunityIO/
├── src/           # React application source
├── public/        # Static assets
├── server.js      # Express SEO / production server
├── vite.config.ts # Vite configuration
└── dist/          # Production build output (generated)

Contributing

We welcome contributions! Please read:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md — report vulnerabilities privately

Support

See SUPPORT.md for help channels.

License

Licensed under the Apache License 2.0. See NOTICE for attribution.