이 프로젝트는 그누보드5의 기존 관리자와 데이터를 유지하면서, PHP API를 통해 React Native Android·iOS 앱과  Next.js 웹 테마를 연결하는 오픈소스 프로젝트입니다.

실험적인 프로젝트이며 아직 미흡한 부분이 많지만 공개합니다.

관리와 데이터는 그누보드에 두고, 그누보드5는 api 를 제공해서, 사용자 화면만 웹과 앱으로 넓히는 구조입니다.
그누보드 원본 파일은 고치지 않고 플러그인·extend 방식으로 얹습니다.

이 프로젝트는 그누보드5를 기반으로 웹과 모바일 서비스를 함께 운영할 수 있도록 확장합니다. 운영자는 기존 그누보드 관리자 화면과 데이터를 사용하고, Next.js 웹 테마와 React Native Android·iOS 앱은 PHP API를 통해 같은 서비스 기능을 이용합니다.
목표는 그누보드 코어를 직접 수정하지 않고 브리지와 확장 계층을 통해 기능을 연결하는 것입니다.

구성 요소

핵심은 관리와 데이터는 그누보드에 두고, 사용자 화면은 웹과 앱으로 확장하는 구조입니다.
 

■ 저렴한 웹호스팅에서도 돌아갑니다
Next.js 테마는 미리 빌드해 둔 파일을 PHP가 내보내는 방식이라 서버에 Node.js가 없어도 됩니다.
월 500원짜리 카페24 웹호스팅에서도 돌아가도록 신경 썼습니다. 루트 설치와 하위 폴더 설치 모두 됩니다.

■ 데모 (아이디 demo / 비밀번호 1234)
- 그누보드에 테마를 설치한 사이트 : https://thisgun3.mycafe24.com/
- 같은 테마를 Vercel에 띄운 데모 : https://gnuboard5-nextjs-demo.vercel.app/
- 앱 화면 (Expo 웹 빌드) : https://thisgun3.mycafe24.com/demo/
※ 데모 계정은 여러 분이 함께 쓰므로 개인 정보는 넣지 말아 주세요.

■ 설치
1. 아래 저장소의 Releases에서 gnuboard5-nextjs-vX.Y.Z.zip 을 받습니다. (Source code 압축이 아닙니다)
2. 그누보드 루트에 풉니다.
3. /api/v1/status 가 정상인지 확인하고, 관리자 > 환경설정 > 테마설정에서 "Next.js Default"를 적용합니다.
앱만 쓰시더라도 API는 이 zip으로 먼저 설치해야 합니다. 자세한 내용은 매뉴얼과 저장소의 INSTALL.md를 봐 주세요.
요구 사항 : 그누보드5 5.6.26 이상 (5.6.41에서 확인), PHP 7.4 이상

■ 링크
- 매뉴얼 : https://gnuboard5-apps-manual.vercel.app/
- 웹 테마 + API (먼저 설치) : https://github.com/gnuboard/gnuboard5-nextjs
- 모바일 앱 (React Native) : https://github.com/gnuboard/gnuboard5-app
두 저장소 모두 LGPL-2.1 라이선스입니다.