縦書き、ルビ、AI校正支援。Windows, macOS, Chromeで動作する執筆環境。文章分析から校正まで、小説家のための機能を凝縮。
A professional-grade Japanese novel editor with vertical writing, ruby notation, and AI proofreading support.
🌍 ランディングページ: https://www.illusions.app/ Chrome版: https://illusions.app/ (Works on latest Chrome/Edge/Safari)
デスクトップ版: Download Latest Release Available for macOS (Intel & Apple Silicon) and Windows (installer or Microsoft Store)
- Milkdown-based Markdown editor with real-time preview
- Vertical writing mode (縦書き) for traditional Japanese novels
- Ruby notation support (ルビ) - furigana for kanji
- Tate-chu-yoko (縦中横) - horizontal text in vertical writing
- AI proofreading support - grammar and style suggestions powered by local LLM engine
- Auto-save every 2 seconds
- Japanese NLP integration for text analysis
- POS (Part-of-Speech) highlighting for Japanese grammar review with live demo preview
- Word frequency analysis for vocabulary insights
- Japanese text linting — 22 rules covering punctuation, number format, joyo kanji, and more (JIS X 4051 / 文化庁標準準拠)
- Correction ignore — dismiss individual lint warnings; per-rule dialogue skip toggle
- Three-column layout: Explorer | Editor | Inspector
- Activity Bar: Quick access to Projects, GitHub, Settings
- Theme system: Automatic light/dark mode support
- Design system dialogs: Custom GlassDialog-based alerts and confirmations (no native browser dialogs)
- Responsive design: Optimized for various screen sizes
- Dual-mode storage:
- Electron: SQLite (fast, unlimited)
- Web: IndexedDB (browser-native)
- GitHub integration: Cloud sync with full version history
- Recent files: Quick access to last 10 documents
- Crash recovery: Auto-restore unsaved content
- Statistics panel: Character count, paragraph count, manuscript pages (原稿用紙)
- Export to PDF/EPUB/DOCX: Export your work to standard publishing formats
- Composition settings: Font, size, line height, spacing
- Version history: Browse and restore previous versions
- Diff viewer: Compare changes between versions
- GitHub OAuth: Device flow authentication
- Auto-commit & push: Automatic version control
- Branch & tag management: Organize your writing milestones
- Cross-platform: Electron app works on macOS, Windows, Linux
- AI status report: View AI model status, storage usage, and diagnostics in the Settings panel
- LLM-based character extraction (キャラクター抽出) — automatically extracts characters (name, aliases, description) from novel text using batched LLM inference
- Multiple LLM model options — Qwen3 (0.6B / 1.7B / 4B) and Gemma-2-Llama-Swallow 9B (日本語特化, 東京科学大学), selectable in Settings
Simply visit https://illusions.app/ in your browser.
- Download the
.dmgfile from GitHub Releases - Open the DMG and drag illusions to your Applications folder
- Launch the app and start writing!
- Download the
.exeinstaller from GitHub Releases - Run the installer
- Important: You may see a Windows SmartScreen warning saying "Unknown Publisher"
- This is normal for unsigned applications
- Click "More info" → "Run anyway" to proceed with installation
- Launch the app and start writing!
Tip: To skip the SmartScreen warning, install from the Microsoft Store instead (search "illusions novel editor").
Why does Windows show this warning?
- illusions is currently distributed without a Windows code signing certificate
- Code signing certificates cost $200-400/year for individual developers
- The app is completely safe and open-source - you can review the code on GitHub
- We plan to add code signing in the future as the project grows
- Node.js 18+
- npm or yarn
# Clone the repository
git clone https://github.com/Iktahana/illusions.git
cd illusions
# Install dependencies
npm install
# Set up environment variables (for GitHub OAuth)
cp .env.local.example .env.local
# Edit .env.local and add your GitHub OAuth Client ID
# Run web development server
npm run devOpen http://localhost:3000 in your browser.
To enable GitHub authentication and cloud sync:
- Create a GitHub OAuth App at https://github.com/settings/applications/new
- Configure the OAuth App:
- Application name:
illusions Novel Editor(or your preferred name) - Homepage URL:
http://localhost:3000 - Authorization callback URL:
http://localhost:3000
- Application name:
- Copy the Client ID from the OAuth App page
- Create a
.env.localfile in the project root:cp .env.local.example .env.local
- Edit
.env.localand replaceyour_client_id_herewith your actual Client ID:GITHUB_CLIENT_ID=your_actual_client_id - Restart the development server
The GitHub avatar will appear at the bottom of the left sidebar, allowing you to log in and sync your work.
# Run Electron app in development mode
npm run electron:dev
# Build Electron app for production
npm run electron:build# Generate credits.json (list of production dependency licenses)
npm run generate:creditsThe generated file is used in the "About illusions" page in Settings.
illusions/
├── app/ # Next.js App Router pages
│ ├── api/ # API routes (NLP endpoints)
│ ├── globals.css # Global styles & theme variables
│ └── page.tsx # Main editor page
├── components/ # React components
│ ├── Editor.tsx # Milkdown editor
│ ├── Explorer.tsx # Left sidebar
│ ├── Inspector.tsx # Right sidebar
│ ├── ActivityBar.tsx # Left activity bar
│ └── github/ # GitHub integration UI
├── lib/ # Core libraries
│ ├── storage-service.ts # Storage factory
│ ├── electron-storage.ts # Electron storage provider
│ ├── web-storage.ts # Web storage provider
│ ├── linting/ # Japanese text linting framework
│ ├── nlp-client/ # NLP client abstraction
│ ├── llm-client/ # LLM client abstraction + model registry
│ ├── character-extraction/ # LLM-based character extraction
│ ├── git/ # Git service (isomorphic-git)
│ ├── github/ # GitHub API integration
│ └── hooks/ # React hooks
├── nlp-service/ # Electron NLP backend
├── types/ # TypeScript type definitions
├── docs/ # Documentation
└── main.js # Electron main process
- Next.js 16 - React framework with App Router
- React 18 - UI library
- TypeScript - Type-safe development
- Tailwind CSS 3 - Utility-first styling
- Milkdown 7 - WYSIWYG Markdown editor
- ProseMirror - Editor foundation
- Kuromoji.js - Japanese morphological analysis
- Dexie.js - IndexedDB wrapper (Web)
- better-sqlite3 - SQLite database (Electron)
- isomorphic-git - Git implementation in JavaScript
- @octokit/rest - GitHub API client
- Vitest - Unit testing framework
- Electron 32 - Cross-platform desktop app
- electron-builder - Build and packaging
- electron-updater - Auto-update support
- Quick Start Guide - Get started in 5 minutes
- Storage Documentation - Storage architecture and API
- NLP Backend Architecture - Japanese text processing
- Notification System - Toast notification API
- Theme Colors Guide - Theming system
illusions の校正（リンティング）機能は、以下の公的標準・業界規範に準拠しています。 検出された問題は、必ず準拠する標準名を明示してユーザーに提示します。
The proofreading (linting) features in illusions comply with the following official standards. All detected issues cite their source standard when presented to users.
| Standard | Scope | Reference |
|---|---|---|
| JIS X 4051:2004 | 日本語文書の組版方法（禁則処理・約物・ルビ） | Full text |
| 文化庁「公用文作成の考え方」(2022) | 公用文の句読点・用字用語 | |
| W3C JLREQ | 日本語組版処理の要件（Web/デジタル組版） | W3C |
| 文化庁 常用漢字表 (2010) | 常用漢字 2,136字 | 文化庁 |
- ✅ Milkdown editor with vertical writing
- ✅ Ruby notation (ルビ) support
- ✅ Tate-chu-yoko (縦中横) support
- ✅ AI proofreading support
- ✅ Auto-save and crash recovery
- ✅ Storage abstraction (Electron + Web)
- ✅ GitHub integration with OAuth
- ✅ Version history and diff viewer
- ✅ Japanese NLP backend
- ✅ POS highlighting
- ✅ Word frequency analysis
- ✅ Landing page with SEO optimization
- ✅ LLM-based character extraction — automatically extract characters from novel text with batched LLM inference (キャラクター抽出)
- ✅ Gemma-2-Llama-Swallow 9B model — Japanese-optimised reasoning LLM by 東京科学大学, available in LLM settings (日本語特化モデル)
- ✅ Error notifications for file operation failures — toast alerts on save/load errors
- ✅ AI report in settings panel — view AI model status, storage usage, and system diagnostics (AIレポート)
- ✅ Microsoft Store packaging — Windows
.appxbuild target and tile assets for Store distribution - ✅ LLM idling stop — auto-unload AI model after 30s idle to reduce memory usage (AIアイドリングストップ)
- ✅ Export to PDF/EPUB/DOCX — export novels to standard publishing formats
- ✅ Local LLM engine for AI proofreading (ローカルLLMによるAI校正)
- ✅ Correction ignore feature — dismiss individual lint warnings
- ✅ Dialogue-aware linting — skip dialogue content with per-rule toggle
- ✅ Live demo preview for POS highlight settings
- ✅ 22 lint rules (15 L1 regex + 7 L2 morphological) with 5 presets
- ✅ In-app notification for power saving (replaces native dialog)
- ✅ Unit test coverage for core library modules (Vitest)
- ✅ Japanese text linting framework (JIS X 4051 / 文化庁標準準拠)
- ✅ Electron security hardening (CSP, navigation guards, safeStorage, IPC input validation, save-file path validation)
- ✅ Design system dialogs replacing native browser alerts/confirms (GlassDialog)
- ✅ Accurate Japanese text statistics (文字数 character count, misleading word count removed)
- Real-time collaboration
- Advanced AI grammar and style checking (local LLM integration in progress)
- Custom themes and fonts
- Plugin system
- Mobile app (iOS/Android)
- Token encryption: OS-level encryption via Electron safeStorage (macOS Keychain / Windows DPAPI)
- Context isolation: Electron preload with secure IPC, sandbox enabled
- IPC input validation: Type and size checks on security-sensitive IPC handlers (VFS, NLP, file operations, context-menu)
- Save-file path validation: Directory traversal prevention, system path denylist, extension allowlist, and dialog-approval enforcement
- Content Security Policy: CSP headers enforced;
unsafe-evaldisabled in production - Navigation guards: Blocks unexpected navigation and new-window creation
- VFS sandboxing: File system access restricted to approved project directories
- HTTPS only: All network requests use HTTPS
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please follow the code review standards in CLAUDE.md.
GNU Affero General Public License v3.0 - See LICENSE file for details.
See also: 利用規約 / Terms of Service | Online Policy Page
- Milkdown - Excellent Markdown editor framework
- Kuromoji.js - Japanese text tokenization
- isomorphic-git - Pure JavaScript Git implementation
- Electron - Cross-platform desktop framework
- GitHub Issues: https://github.com/Iktahana/illusions/issues
- Website: https://www.illusions.app
- Chrome版: https://illusions.app
Q: Windows でインストール時に「不明な発行元」と表示されます。安全ですか？
A: はい、安全です。この警告は、アプリケーションが Microsoft の認証を受けた署名がないために表示されます。
原因:
- コード署名証明書は年間 $200-400 の費用がかかります
- 個人開発プロジェクトのため、現時点では署名を購入していません
- すべてのソースコードは GitHub で公開されており、誰でも確認できます
インストール方法:
- インストーラーをダブルクリック
- 「Windows によって PC が保護されました」と表示される
- 「詳細情報」をクリック
- 「実行」ボタンをクリック
- インストールが開始されます
セキュリティについて:
- ✅ オープンソース（コードは GitHub で公開）
- ✅ GitHub Actions で自動ビルド
- ✅ マルウェアスキャン済み
- ✅ コミュニティによるコードレビュー
将来的には、プロジェクトの成長に伴いコード署名証明書を取得する予定です。
Q: Windows shows "Unknown Publisher" warning during installation. Is it safe?
A: Yes, it's completely safe. This warning appears because the app doesn't have a Microsoft-verified signature.
Why this happens:
- Code signing certificates cost $200-400/year
- As an individual developer project, we haven't purchased signing yet
- All source code is public on GitHub and can be reviewed by anyone
How to install:
- Double-click the installer
- When you see "Windows protected your PC", click "More info"
- Click "Run anyway"
- Installation will proceed normally
Security:
- ✅ Open source (code publicly available on GitHub)
- ✅ Built automatically with GitHub Actions
- ✅ Malware scanned
- ✅ Community code reviewed
We plan to obtain a code signing certificate as the project grows.
Made with ❤️ for Japanese novelists