|
1 | | -# create-akiradocs |
2 | 1 |
|
3 | | -Create Akira Docs documentation sites with one command. |
| 2 | +<p align="center"> |
| 3 | + <h1 align="center">AkiraDocs</h1> |
| 4 | +</p> |
4 | 5 |
|
5 | | -## Usage |
| 6 | +<p align="center"> |
| 7 | + <a href="https://discord.gg/zvYZukgeH2"> |
| 8 | + <img src="https://img.shields.io/badge/Join_Our_Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white" alt="Join Our Discord"> |
| 9 | + </a> |
| 10 | +</p> |
| 11 | + |
| 12 | +<p align="center"> |
| 13 | + <h4 align="center"><strong>Beautiful docs that write, translate, and optimize themselves</strong></h4> |
| 14 | +</p> |
| 15 | + |
| 16 | +<p align="center"> |
| 17 | + <img src="gifs/star_the_repo.gif" alt="Star the Repo" width="100%"> |
| 18 | +</p> |
| 19 | + |
| 20 | +<p align="center"> |
| 21 | + If you find AkiraDocs useful, please consider giving it a star! ⭐️<br> |
| 22 | + Your support helps us continue improving the platform. |
| 23 | +</p> |
| 24 | + |
| 25 | + |
| 26 | +<p align="center"> |
| 27 | + <a href="https://demo.akiradocs.ai"> |
| 28 | + <img src="https://img.shields.io/badge/Try_Demo-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Live Demo"> |
| 29 | + </a> |
| 30 | + <a href="https://forms.gle/KunU4BGhToH4NJ1t7"> |
| 31 | + <img src="https://img.shields.io/badge/Join_Waitlist_For_Cloud_Hosting-FF6B6B?style=for-the-badge&logo=googleforms&logoColor=white" alt="Join Waitlist for Cloud Hosting"> |
| 32 | + </a> |
| 33 | +</p> |
| 34 | + |
| 35 | +## 🚀 What is AkiraDocs? |
| 36 | +AkiraDocs is a modern documentation platform that combines the power of AI with a Notion-like editing experience. Create, translate, and optimize your documentation automatically while maintaining complete control over the content. Perfect for teams who want to focus on their ideas rather than the complexities of documentation management. |
| 37 | + |
| 38 | + |
| 39 | +## ⚡️ Quick Deploy |
| 40 | +Get started in seconds: |
| 41 | + |
| 42 | +[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FCloud-Code-AI%2Fakiradocs-template) |
| 43 | + |
| 44 | +Or via CLI: |
6 | 45 | ```bash |
7 | | -npx create-akiradocs mydocs |
| 46 | +npx create-akiradocs <optional folder name> |
8 | 47 | ``` |
9 | 48 |
|
10 | | -## Features |
| 49 | + |
11 | 50 |
|
12 | | -- 📝 Block-based content editing |
13 | | -- 🎨 Customizable themes |
14 | | -- 🔍 AI-powered search |
15 | | -- 📱 Responsive design |
16 | | -- ⚡ Next.js based |
17 | | -- 🎯 SEO optimized |
| 51 | +## 🎯 Perfect For |
| 52 | +- **Developers**: API docs, SDK guides, implementation examples |
| 53 | +- **Product Teams**: User guides, release notes, tutorials |
| 54 | +- **Enterprises**: Internal wikis, process documentation, knowledge bases |
18 | 55 |
|
19 | | -## Requirements |
| 56 | +## ✨ Key Features |
20 | 57 |
|
21 | | -- Node.js 16 or later |
| 58 | +### Notion-like Editor |
| 59 | +Intuitive block-based interface with real-time preview |
22 | 60 |
|
23 | | -## Creating a Project |
| 61 | + |
24 | 62 |
|
25 | | -1. Create a new project: |
26 | | - ```bash |
27 | | - npx create-akiradocs@latest my-docs |
28 | | - ``` |
| 63 | +### AI-Powered Content Generation |
| 64 | +Automatically enhance your content with AI |
29 | 65 |
|
30 | | -2. Navigate to the project: |
31 | | - ```bash |
32 | | - cd my-docs |
33 | | - ``` |
| 66 | + |
34 | 67 |
|
35 | | -3. Install dependencies: |
36 | | - ```bash |
37 | | - npm install |
38 | | - ``` |
| 68 | +### Translation |
| 69 | +Translate your content to multiple languages with AI |
39 | 70 |
|
40 | | -4. Start the development server: |
41 | | - ```bash |
42 | | - npm run dev |
43 | | - ``` |
| 71 | + |
44 | 72 |
|
45 | | -5. Open [http://localhost:3000](http://localhost:3000) in your browser. |
| 73 | +### 🔍 AI-Generated SEO Optimization |
| 74 | +Automatically optimize your documentation for search engines with AI-driven SEO |
| 75 | +- Improve discoverability and reach without manual SEO adjustments |
| 76 | +- AI recommendations for keywords and metadata |
46 | 77 |
|
47 | | -## Updating a Project |
| 78 | +### 🛠 Developer-Friendly |
| 79 | +- Keep your existing Markdown/Git workflow |
| 80 | +- Full Markdown/MDX support |
| 81 | +- Easy custom component development |
| 82 | +- SEO optimization out of the box |
48 | 83 |
|
49 | | -To update an existing Akira Docs site to the latest version: |
| 84 | +### 📝 Content Creator-Friendly |
| 85 | +- Modern block-based WYSIWYG editor |
| 86 | +- Real-time previews |
| 87 | +- Rich media support |
| 88 | +- Reusable content blocks |
50 | 89 |
|
51 | | -```bash |
52 | | -npx update-akiradocs |
53 | | -``` |
54 | 90 |
|
55 | | -This will update your project while preserving your content and configuration files. |
| 91 | +## 🌍 Going Global |
| 92 | +Built-in AI-powered translation. Just add API keys: |
| 93 | +```json |
| 94 | +{ |
| 95 | + "translation": { |
| 96 | + "auto_translate": true, |
| 97 | + "provider": "anthropic", |
| 98 | + "targetLanguages": ["es", "fr", "de"] |
| 99 | + } |
| 100 | +} |
56 | 101 | ``` |
57 | 102 |
|
58 | | -Now users can update their existing Akira Docs sites using: |
59 | | -```bash |
60 | | -npx update-akiradocs |
61 | | -``` |
| 103 | +### 🤖 Upcoming Features |
| 104 | +- **AI-Powered Documentation Generation** |
| 105 | + - Automatically generate comprehensive documentation from your codebase |
| 106 | + - AI-assisted content updates to keep your docs current with minimal effort |
| 107 | + - Intelligent suggestions for content improvements and expansions |
62 | 108 |
|
63 | | -This implementation: |
64 | | -1. Preserves user content by ignoring `_contents`, `contents`, and `akiradocs.config.json` |
65 | | -2. Updates all other files with the latest template |
66 | | -3. Provides a simple command-line interface |
67 | | -4. Shows progress with a spinner and clear success/error messages |
68 | | -5. Maintains the same code style and structure as the existing codebase |
69 | 109 |
|
70 | | -The update command will copy the latest template files while preserving user-specific content and configuration files. |
| 110 | +## 🔄 Easy Migration (Coming Soon) |
| 111 | +Import your existing docs: |
| 112 | +```bash |
| 113 | +npx akiradocs-migrate import --from=source --to=mydocs |
| 114 | +# Supports: GitBook, Docusaurus, ReadTheDocs, Confluence, Notion |
| 115 | +``` |
71 | 116 |
|
72 | | -## Documentation |
| 117 | +## 🤝 Join Our Community |
| 118 | +- [Live Demo](https://demo.akiradocs.ai) |
| 119 | +- [Documentation](https://docs.akiradocs.com) |
| 120 | +- [Discord Community](https://discord.gg/zvYZukgeH2) |
| 121 | +- [GitHub Discussions](https://github.com/Cloud-Code-AI/akiradocs/discussions) |
| 122 | +- [Join Waitlist](https://forms.gle/KunU4BGhToH4NJ1t7) for early access |
73 | 123 |
|
74 | | -For detailed documentation, visit [docs.akiradocs.com](https://docs.akiradocs.com) |
| 124 | +## 📄 Licensing |
| 125 | +- Open Source (MIT License) |
| 126 | +- Commercial License available for enterprise features |
75 | 127 |
|
76 | | -## License |
| 128 | +--- |
77 | 129 |
|
78 | | -MIT |
| 130 | +[Get Started](https://docs.akiradocs.ai/quickstart) • |
| 131 | +[Live Demo](https://demo.akiradocs.ai) • |
| 132 | +[Enterprise Trial](https://akiradocs.com/enterprise) (Coming Q1 2025) |
0 commit comments