https://github.com/kychee-com/kychon
AI-powered membership/community portal template
https://github.com/kychee-com/kychon
Last synced: 3 months ago
JSON representation
AI-powered membership/community portal template
- Host: GitHub
- URL: https://github.com/kychee-com/kychon
- Owner: kychee-com
- Created: 2026-03-27T20:45:48.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T09:56:20.000Z (3 months ago)
- Last Synced: 2026-04-14T10:16:33.417Z (3 months ago)
- Language: Astro
- Size: 38.5 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Kychon
[](https://github.com/kychee-com/kychon)
[](LICENSE)
[](https://biomejs.dev)
[](https://run402.com)
[](https://kychon.com/#ai)
A forkable, AI-powered membership portal built on [Run402](https://run402.com). One deploy gives your community a full-featured site with member directory, events, forum, resources, committees, and built-in AI moderation and translation.
**Live demo:** [eagles.kychon.com](https://eagles.kychon.com)
**Marketing site:** [kychon.com](https://kychon.com)
## Features
- **Member Directory** - Searchable profiles with custom fields and tier badges
- **Events & RSVP** - Create events, collect RSVPs, send reminders
- **Forum** - Categories, topics, replies with reactions
- **Resources** - File library with categories and member-only access
- **Committees** - Working groups with members, chairs, and descriptions
- **Announcements** - Pinned posts with reactions and activity feed
- **AI Moderation** - Built-in content moderation via Run402 (free, no API key)
- **AI Translation** - Built-in auto-translation via Run402 (no API key)
- **Inline Editing** - Admins edit content directly on the page
- **i18n** - Full internationalization with translation files
- **Config-Driven** - Rebrand, toggle features, restructure via database config
- **Dark Mode** - System-aware with manual toggle
## Tech Stack
- **Frontend:** Vanilla JS, HTML5, CSS3 (no frameworks, no build step)
- **Runtime:** Node.js edge functions on Run402
- **Database:** PostgreSQL via Run402 (PostgREST)
- **Auth:** Google OAuth + password (Run402 built-in)
- **Testing:** Vitest + happy-dom + fast-check
- **Linting:** Biome
- **Deploy:** One-command deploy via `deploy.js`
## Quick Start
```bash
# Install dependencies
npm install
# Set up Run402
npm install -g run402
run402 init
run402 tier set prototype
# Provision and deploy
run402 projects provision --name "my-portal"
RUN402_PROJECT_ID= SUBDOMAIN= node deploy.js
```
Your portal is live at `.run402.com`.
## Project Structure
```
kychon/
├── deploy.js # One-command deploy to Run402
├── schema.sql # All tables (idempotent migrations)
├── seed.sql # Default config + sample data
├── site/ # Static frontend
│ ├── *.html # One HTML file per page
│ ├── css/ # Theme variables + component styles
│ ├── js/ # One JS file per feature
│ └── custom/ # Brand config + i18n strings
├── functions/ # Serverless edge functions
├── marketing/ # Marketing site (kychon.com)
├── demo/ # Demo seed data (Eagles, Silver Pines, etc.)
├── tests/ # Unit + integration tests
├── docs/ # Full spec + platform docs
└── openspec/ # Change management artifacts
```
## Development
```bash
# Run tests
npx vitest run
# Lint + format check
npx biome check .
# Type check
npx tsc --noEmit --project jsconfig.json
# All three at once
npm run check
```
## Customization
Kychon is designed to be customized by AI agents. Three tiers:
1. **SQL only** (80%) - Rebrand, toggle features, restructure via `site_config` table
2. **HTML/CSS** (15%) - Visual and layout changes
3. **Full fork** (5%) - New tables, edge functions, page types
See [CUSTOMIZING.md](CUSTOMIZING.md) for the agent guide.
## Demo Portals
| Portal | Description | URL |
|--------|-------------|-----|
| The Eagles | Good Samaritans of Wichita | [eagles.kychon.com](https://eagles.kychon.com) |
| Silver Pines | Senior center with accessibility focus | demo/silver-pines/ |
| Barrio Unido | Spanish-language community center | demo/barrio-unido/ |
## Architecture
The central design principle: **an AI agent's API is SQL for config and file editing for code.**
- **Config-driven**: `site_config` table holds branding, theme, feature flags, nav structure
- **Schema-driven pages**: Homepage sections are database rows, not hardcoded files
- **Inline editing**: The page IS the admin - admins get edit overlays on the same URLs
- **Feature flags, not plugins**: All features ship, toggle with booleans in `site_config`
## License
MIT