G7 커뮤니티 참여 템플릿 - Glitter Aura User

Seed User Template

Glitter Aura는 완성형 디자인 Theme이나 완성된 사이트를 제공하기 위한 Template이 아니라, GnuBoard7 User Template 개발을 시작하기 위한 초기 Seed Template입니다.

Home, Content, Community, Search, Account와 게시글·댓글·작성·권한 처리 등 주요 기능 흐름은 실제 GnuBoard7의 계약을 기반으로 구현되어 있지만, 현재의 UI와 Styling은 기능과 구조를 확인할 수 있는 초기 출발점 수준입니다.

실제 사이트에 적용할 때는 이 Seed를 기반으로 프로젝트에 맞는 Layout, Component, Typography, Color System, Visual Asset, Branding 등을 별도로 설계하고 발전시키는 것을 전제로 합니다.

프로젝트 개요

Glitter Aura는 GnuBoard7에서 새로운 User Template을 개발할 때 기반으로 사용할 수 있도록 만든 Seed User Template입니다.

완성된 디자인 Theme을 설치해서 그대로 사용하는 것을 목표로 하기보다, GnuBoard7의 Template Engine, JSON Layout, Routing, Datasource / Action, sirsoft-board, Backend Ability 같은 실제 기능을 하나의 사용자 흐름으로 연결한 개발 시작점을 제공하는 데 목적이 있습니다.

Seed 자체에는 콘텐츠를 발견하고, 읽고, 커뮤니티에 참여하고, 직접 글을 작성하는 기본적인 사용자 여정을 구현했습니다.

발견 → 탐색 → 읽기 → 대화 → 작성

Home에서 최근 콘텐츠와 Community를 발견하고, Content에서 게시판과 콘텐츠를 탐색하거나 Search에서 전체 글을 찾은 뒤, Community에서 특정 게시판의 참여 흐름으로 들어갑니다.

글 상세에서는 본문을 읽는 것에서 끝나지 않고 첨부파일, 이전·다음 글, 댓글과 답글로 이어지며 Backend Ability가 허용하는 경우 글 작성과 수정으로도 연결됩니다.

Home
  │
  ├── Content
  │      │
  │      └── Post
  │
  ├── Search
  │
  └── Community
         │
         ├── Post
         │    └── Discussion
         │
         └── Authoring

별도의 게시판 시스템이나 Community 데이터베이스, 독립적인 권한 체계를 만들지 않습니다.

GnuBoard7의 게시판, 권한, Template Engine, JSON Layout, Routing 구조를 그대로 활용하면서 User Template에서 콘텐츠와 커뮤니티 기능을 어떻게 연결할 수 있는지를 보여주는 실제 동작 가능한 Seed를 제공하는 것을 목표로 합니다.

현재 기본적인 Visual Direction도 포함되어 있지만 이는 완성된 Theme Design을 의미하지 않습니다.

여백, 시스템 고딕 Typography, Sage / Olive 계열 색상, 반응형 Layout, Light / Dark Mode 등의 기본 Styling은 Seed의 기능과 화면 구조를 확인할 수 있도록 제공하는 초기값이며, 실제 프로젝트에서는 이를 자유롭게 변경하고 확장하는 것을 전제로 합니다.

주요 특징

Content-first Home

홈 화면은 단순한 Template 소개 화면이 아니라 실제 GnuBoard7 데이터를 이용해 콘텐츠 탐색을 시작하는 구조입니다.

• Selected Stories
• Latest Content
• Community Highlight
• Editorial / Brand Section
• Content / Search 진입
• Community 진입
• 콘텐츠가 없을 때의 Empty State

Selected Stories에서는 최근 글 가운데 하나를 조금 더 편집적인 형태로 보여주고, Latest Content에서는 최근 게시물을 이어서 탐색할 수 있습니다.

Community Highlight에서는 공개 게시판을 보여주어 Home에서 바로 Community 흐름으로 들어갈 수 있습니다.

여기서 Trending, Popular, Recommended 같은 의미를 임의로 붙이지 않습니다.

Backend가 제공하지 않는 의미를 Frontend에서 만들어내지 않는다는 원칙을 유지합니다.

Content Discovery

/content는 여러 게시판을 발견하고 콘텐츠를 둘러보기 위한 영역입니다.

• 게시판 기반 Content 탐색
• 게시판 선택
• 게시물 목록
• Content Detail
• HTML / Text Content Mode
• 첨부파일
• 이전 / 다음 글
• Mobile / Tablet / Desktop 대응

Content와 Community는 동일한 sirsoft-board 데이터를 사용하지만 역할을 구분합니다.

Content는 여러 게시판과 게시물을 발견하고 탐색하고 읽는 흐름에 가깝고, Community는 특정 게시판 안에서 읽기와 참여가 이어지는 흐름에 초점을 맞춥니다.

Community

/community/{slug}는 특정 게시판 안에서 읽기와 참여가 이어지는 Community 경험의 기본 구현을 제공합니다.

Community Board
      │
      ▼
Search / Pagination
      │
      ▼
Post
      │
      ├── Comments
      ├── Replies
      └── Authoring

주요 기능은 다음과 같습니다.

• 게시판별 Community
• 서버 기반 검색
• 서버 Pagination
• URL 기반 게시판 / 검색 Context 유지
• Post Detail
• 댓글
• 답글
• 댓글 수정 / 삭제
• 비회원 확인 과정
• 글 작성 / 수정
• Backend Ability 기반 권한 처리

Community 검색과 Pagination은 서버가 제공하는 정보를 사용합니다.

페이지 수를 Frontend에서 임의로 계산하지 않으며 검색어와 게시판 Context도 URL과 함께 유지합니다.

Post Reading & Discussion

Community Post Detail은 본문을 읽는 것에서 댓글과 답글을 통한 대화까지 이어지는 기본 흐름을 구현합니다.

• Plain Text / HTML Content Mode
• Sanitized HTML Rendering
• 첨부파일
• 이전 / 다음 글
• 댓글
• 답글
• 댓글 수정 / 삭제
• Guest Verification
• Backend Comment Depth / Max-depth Contract

댓글 깊이 역시 Frontend에서 별도의 규칙을 만들어 처리하지 않고 서버가 제공하는 parent_id, depth, max-depth 규칙을 따릅니다.

여러 데이터 요청의 상태도 가능한 한 분리합니다.

예를 들어 댓글을 불러오지 못했다고 정상적으로 받은 글 본문까지 제거하지 않으며, 이전·다음 글 요청이 실패하더라도 본문과 정상적으로 받은 다른 영역은 계속 사용할 수 있도록 구성했습니다.

이러한 구현은 완성된 Community Product를 제공하기 위한 것이라기보다, GnuBoard7 User Template에서 Reading과 Discussion 흐름을 연결하는 하나의 Seed 구현 사례로 제공됩니다.

Post Authoring

Community에서는 Backend Ability가 허용하는 경우 글 작성과 수정이 가능합니다.

• 제목
• 본문
• Category
• Secret 옵션
• Guest Name / Password
• Create / Edit
• Field Validation Error
• 중복 제출 방지
• 입력값 보존
• content_mode 보존

서버 Validation 오류는 가능한 한 각 Field 가까이에 표시하며 저장 중에는 중복 제출을 방지합니다.

오류가 발생한 경우 사용자가 입력한 일반 값은 가능한 한 유지하되 Password와 같은 민감한 값은 별도로 처리합니다.

HTML 글을 수정할 때는 서버가 제공한 content_mode를 그대로 유지합니다.

현재 별도의 WYSIWYG Editor는 제공하지 않으며 HTML 글은 textarea에서 HTML Source를 직접 편집합니다.

콘텐츠 구조

Home, Content, Community, Search가 각각 독립적인 게시판 데이터 체계를 만들지 않습니다.

GnuBoard7과 sirsoft-board가 제공하는 게시판 데이터와 권한을 Datasource / Action을 통해 각 화면에서 사용합니다.

Template UI
      │
      ▼
Datasource / Action
      │
      ▼
GnuBoard7 API / sirsoft-board
      │
      ▼
Backend Data & Permission Authority

또한 실제 GnuBoard7 데이터에 없는 의미나 권한을 Template에서 임의로 만들어내지 않는 것을 원칙으로 했습니다.

예를 들어:

• 로그인 여부만으로 글쓰기 권한을 추측하지 않습니다.
• user_abilities.can_write와 같은 Backend Ability를 사용합니다.
• 댓글 읽기 / 쓰기도 Backend Permission을 따릅니다.
• 사이트 설정이 허용하면 비회원도 글이나 댓글에 참여할 수 있습니다.
• 페이지 수를 Frontend에서 임의로 계산하지 않습니다.
• Backend가 제공하지 않는 Popular / Trending 의미를 만들지 않습니다.
• 확인되지 않은 Attachment Transport를 임의로 구현하지 않습니다.

즉 새로운 Community Engine을 G7 안에 다시 만드는 대신, 기존 G7의 데이터와 권한 계약을 User Template에서 어떻게 활용할 수 있는지를 보여주는 작은 Template Layer를 두었습니다.

Seed를 기반으로 새로운 Template을 개발할 때도 이 구조를 그대로 유지할 필요는 없습니다.

프로젝트 목적에 따라 Home이나 Content를 제거하거나 Community 중심으로 재구성하는 등 필요한 부분만 가져가서 확장할 수 있도록 하는 것이 Seed Template의 목적입니다.

디자인

Glitter Aura의 현재 디자인은 완성형 Theme이나 완성된 Design System을 의미하지 않습니다.

Home, Content, Community, Search, Account 등의 실제 기능과 화면 구조를 확인할 수 있도록 기본적인 Styling을 적용한 상태이며, 세부적인 시각적 완성도를 목표로 한 Release는 아닙니다.

현재 기본적인 Visual Direction은 다음과 같습니다.

• System Gothic / Sans-serif Typography
• 넓은 Whitespace
• Sage / Olive 계열의 낮은 채도
• 밝은 Neutral Surface
• 얇은 Border
• 절제된 Radius
• Sparse Metadata
• 비대칭 Desktop Grid
• Single-column Mobile Flow
• Light / Dark Color Scheme
• 이미지에 의존하지 않는 Home Composition

기본 글꼴은 별도의 Web Font를 내려받지 않고 시스템 고딕 계열을 사용합니다.

"Apple SD Gothic Neo",
"Malgun Gothic",
"맑은 고딕",
"Noto Sans KR",
system-ui,
-apple-system,
BlinkMacSystemFont,
"Segoe UI",
sans-serif

본문뿐 아니라 큰 제목, Brand, Hero, Article Heading도 같은 Sans-serif 계열을 사용하고 Code 영역만 Monospace를 유지합니다.

반복적인 Card, Shadow, Gradient로 화면을 구획하기보다 Typography, Spacing, Alignment, Border, Grid Rhythm을 사용해 기본적인 정보 계층을 표현합니다.

홈 화면의 기하학적 장식 역시 별도의 이미지 Asset에 의존하지 않고 CSS로 구성합니다.

다만 이러한 요소들은 특정 브랜드의 완성된 디자인 언어를 정의하기 위한 것이 아니라, Seed 상태에서도 콘텐츠 구조와 사용자 흐름을 확인할 수 있도록 제공하는 초기 Styling입니다.

실제 프로젝트에서는 다음과 같은 영역을 프로젝트 목적에 맞게 다시 설계하는 것을 전제로 합니다.

• Branding
• Color System
• Typography
• Layout
• Component Styling
• Navigation
• Visual Asset
• Interaction
• Motion / Animation
• 세부 Responsive Design

따라서 Glitter Aura의 현재 화면을 최종 디자인 결과물로 보기보다는, 기능이 연결된 상태에서 디자인 작업을 시작할 수 있는 기본 Canvas로 보는 것이 적절합니다.

GnuBoard7 Integration

Glitter Aura는 기존 G7 확장 구조 안에서 동작합니다.

• GnuBoard7 Template Engine
• User Template
• JSON Layout
• React Component
• Template Routing
• Datasource / Action
• i18n
• sirsoft-board
• Backend Ability Contract
• Guest Permission Contract
• Template Lifecycle
• Prebuilt Production Assets
• Light / Dark Color Scheme

별도의 Core 수정 없이 설치할 수 있습니다.

Seed Template 자체에서 새로운 Backend Framework나 별도의 Community Module을 만들기보다 GnuBoard7이 이미 제공하는 계약을 User Template에서 사용하는 방법을 보여주는 것에 초점을 맞춥니다.

다국어

현재 다음 언어를 제공합니다.

• 한국어 (ko)
• 영어 (en)

Template의 고정 UI 문구는 Language Key로 관리하며 실제 게시글 제목, 본문, 사용자 이름 같은 동적 콘텐츠는 원본 데이터를 사용합니다.

동적인 이름, 개수, 날짜 등은 Translation Parameter를 통해 전달합니다.

Layout에 특정 언어의 UI 문장을 직접 넣기보다 Translation Key를 사용하는 구조를 Seed 단계부터 적용했습니다.

기술 스택

• GnuBoard7
• PHP 8.3+
• Laravel 12.x
• React
• TypeScript
• JSON Layout
• Vite
• sirsoft-board

Production CSS / JavaScript가 Release에 포함되므로 일반적인 Template 설치를 위해 별도의 Node.js Production Build를 수행할 필요는 없습니다.

다만 Glitter Aura를 Seed로 사용하여 Source를 수정하고 새로운 Template으로 개발하는 경우에는 해당 개발 환경에서 TypeScript와 Production Asset Build 과정이 필요할 수 있습니다.

현재 상태

Seed User Template — v1.4.38

현재 Glitter Aura는 GnuBoard7 User Template 개발을 위한 초기 Seed Template 단계입니다.

기본적인 사용자 흐름과 G7 Integration은 실제 동작하도록 구현되어 있지만, UI와 Visual Styling의 완성도를 목표로 한 Production Theme Release는 아닙니다.

현재 구현된 주요 범위는 다음과 같습니다.

• Content-first Home
• Selected Stories
• Latest Content
• Community Highlight
• Content Discovery
• Content Detail
• Community Board
• Community Search / Pagination
• Post Reading
• Comments / Replies
• Post Create / Edit
• Guest Participation
• Backend Ability 기반 Permission
• HTML / Text Rendering
• Sanitized HTML
• Attachment Reading / Download
• Previous / Next Post
• Search
• Login / Register
• Password Reset
• Account / Profile
• Responsive UI
• Light / Dark Mode
• 한국어 / 영어
• G7 Template Lifecycle
• 독립 GitHub Repository
• ZIP / TAR.GZ Release Package

현재 Release의 중심은 완성된 스타일을 제공하는 것보다 GnuBoard7 User Template에서 필요한 주요 화면과 데이터·권한 흐름을 실제 코드와 Layout으로 제공하는 것에 있습니다.

버전 번호 v1.4.38은 Seed Template의 기능 구현과 내부 개선 과정에서 누적된 버전이며, 디자인 완성도를 의미하는 버전 번호는 아닙니다.

Glitter Aura는 v1.4.38부터 독립 GitHub Repository를 통한 공개 Release를 시작했습니다.

현재 제한사항

가장 먼저, 현재 Glitter Aura는 스타일 완성도를 목표로 한 Production Theme이 아닙니다.

화면별 기본 Layout, Responsive Styling, 시스템 고딕 Typography, Light / Dark Mode 등은 구현되어 있지만 다음과 같은 영역까지 완성된 Design System을 제공하는 단계는 아닙니다.

• 프로젝트별 Branding
• 완성된 Component Design System
• 정교한 Visual Asset
• 고도화된 Motion / Interaction
• 세부적인 화면별 Art Direction
• 특정 서비스에 최적화된 UX
• Production Brand 수준의 Styling 완성도

실제 사이트에 적용할 때는 프로젝트 성격에 맞는 별도의 디자인 및 Branding 작업을 권장합니다.

기능적으로도 현재 다음 기능은 Template에서 임의로 추가하지 않았습니다.

• WYSIWYG HTML Editor
• 독립적인 Attachment Upload
• Attachment Replace / Delete
• Comment Pagination
• 별도의 Community DB / CRUD / Module
• Backend에 없는 Popular / Trending / Recommended 의미

HTML 글을 수정할 때는 WYSIWYG 방식이 아니라 Source Editing 방식을 사용합니다.

글에 첨부된 파일을 읽고 내려받는 것은 가능하지만 User Template 자체에서 사용할 수 있는 검증된 Attachment Upload / Replace / Delete Transport가 없어 작성 화면에 임의의 Upload UI를 만들지 않았습니다.

댓글은 현재 별도의 Pagination을 제공하지 않습니다. 따라서 댓글 수가 매우 많은 글에서는 Backend의 댓글 결과 제한에 따라 전체 Comment Tree가 한 번에 제공되지 않을 수 있습니다.

확인되지 않은 API나 권한을 Template에서 임의로 만들어 흉내 내기보다 현재 GnuBoard7과 sirsoft-board가 제공하는 계약 안에서 실제로 동작하는 범위를 명확하게 유지하는 것을 우선하고 있습니다.

이러한 제한사항 가운데 일부는 단순히 아직 구현하지 못한 기능이라기보다 Seed Template에서 플랫폼 계약이 확인되지 않은 기능을 임의로 만들어 넣지 않기 위한 의도적인 범위 제한이기도 합니다.

이런 경우에 추천합니다

• GnuBoard7 User Template을 처음 만들어보려는 개발자
• G7 User Template의 실제 동작 구조가 필요한 개발자
• JSON Layout 기반 Template 구조를 참고하려는 경우
• sirsoft-board를 User Template에서 사용하는 예제가 필요한 경우
• Datasource / Action 연결 구조를 참고하려는 경우
• Backend Ability 기반 Permission UI 구현을 참고하려는 경우
• 회원 / 비회원 Community 흐름의 구현 사례가 필요한 경우
• Home / Content / Community / Search / Account가 연결된 시작점이 필요한 경우
• 기존 Seed를 자신의 브랜드와 디자인으로 발전시키려는 경우
• 새로운 G7 User Template의 Boilerplate / Reference가 필요한 경우
• 기능이 연결된 상태에서 UI / UX 디자인을 새로 시작하려는 경우
• GnuBoard7 기반 콘텐츠 + 커뮤니티 사이트를 직접 개발하려는 경우

반대로 완성된 디자인을 설치 즉시 그대로 운영할 수 있는 Theme을 찾는 경우에는 현재 Glitter Aura의 목적과 맞지 않을 수 있습니다.

Glitter Aura는 완성된 디자인 상품보다는 직접 수정하고 확장할 GnuBoard7 User Template의 출발점이 필요한 개발자에게 더 적합합니다.

프로젝트 방향

Glitter Aura는 GnuBoard7 안에 또 하나의 게시판이나 Community Engine을 만드는 프로젝트가 아니며, 완성된 디자인 Theme을 제공하는 프로젝트도 아닙니다.

핵심 목적은 GnuBoard7이 이미 제공하는 게시판, 권한, API, Template Lifecycle을 이용하여 새로운 User Template을 개발할 때 출발점으로 사용할 수 있는 실제 동작하는 Seed Template을 제공하는 것입니다.

GnuBoard7
    │
    ├── Template Engine
    ├── JSON Layout
    ├── Routing
    ├── Datasource / Action
    ├── sirsoft-board
    └── Backend Ability
            │
            ▼
       Glitter Aura
        Seed Template
            │
            ▼
     Custom User Template

Seed 자체에도 콘텐츠 발견부터 읽기, 대화, 작성까지 이어지는 하나의 사용자 흐름을 넣었습니다.

발견
  ↓
탐색
  ↓
읽기
  ↓
대화
  ↓
작성

하지만 현재의 Layout과 Styling을 Glitter Aura의 완성된 디자인으로 고정하지 않습니다.

오히려 개발자가 이 구조에서 불필요한 부분을 제거하고 필요한 기능을 추가하면서 Typography, Color, Component, Layout, Branding을 자유롭게 변경해 각 프로젝트에 맞는 새로운 User Template으로 발전시키는 것을 전제로 합니다.

예를 들어 Community가 필요 없는 프로젝트라면 해당 흐름을 제거할 수 있고, 반대로 Community가 중심인 프로젝트라면 Content 영역보다 Community를 중심으로 전체 Information Architecture를 다시 구성할 수 있습니다.

즉 Glitter Aura의 각 화면은 반드시 그대로 유지해야 하는 제품 사양이 아니라 G7의 실제 기능을 연결해 놓은 참고 가능한 Seed 구현입니다.

또한 Backend가 제공하지 않는 기능이나 의미를 Seed Template에서 임의로 만들어내지 않는 것을 중요한 원칙으로 두고 있습니다.

Glitter Aura의 목표는 완성된 사이트를 대신 만들어주는 것이 아니라,

GnuBoard7 User Template 개발을 어디서부터 시작해야 하는지 보여주는 실제 동작 가능한 출발점

을 제공하는 것입니다.

요구사항

GnuBoard7

GnuBoard7 >= 7.0.11

PHP

PHP 8.3+

필수 확장

• 게시판 모듈 (sirsoft-board >= 1.1.2)

별도의 독립 Community Module이나 Editorial CMS를 필수 Dependency로 사용하지 않습니다.

관리자에서 템플릿만 설치

• 템플릿 ID: glitter-aura_user
• Template Type: User Template
• 현재 버전: v1.4.38
• 성격: Seed User Template

1. GitHub 저장소에서 설치

관리자 → 템플릿 관리 → 수동 설치 → GitHub

아래 저장소 URL을 입력합니다.

https://github.com/glitter-node/glitter-aura_user

설치 완료 후 Glitter Aura 템플릿을 활성화합니다.

설치되는 기본 화면과 Styling은 완성형 Theme이라기보다 Seed Template의 기본 구현입니다.

실제 사이트를 제작할 경우 설치 후 프로젝트에 맞는 디자인과 기능 수정 작업을 진행하는 것을 전제로 합니다.

2. ZIP 패키지 설치

GitHub Release에서 다음 패키지를 다운로드합니다.

• ZIP 템플릿 패키지를 다운로드

다운로드한 ZIP 패키지를 다음 경로에서 설치합니다.

관리자 → 템플릿 관리 → 수동 설치 → 파일 업로드

설치 완료 후 Glitter Aura 템플릿을 활성화합니다.

3. 설치 후 생성된 페이지의 로드 에러 발생 시

관리자 → 환경설정 → 고급 → 캐시 모두 삭제

Demo / Repository

Demo

https://php.zox.kr/

Demo는 Glitter Aura Seed의 기능과 기본 화면 구성을 확인하기 위한 용도이며, 최종적인 디자인 완성도를 제시하기 위한 Showcase Demo는 아닙니다.

GitHub

https://github.com/glitter-node/glitter-aura_user

Release

Glitter Aura v1.4.38

라이선스

MIT License

Copyright © 2026 Glitter.kr