|
1 | | -# Clariodocs | API Documentation Generator |
2 | | - |
3 | | -Transform your API specification into a clean, branded, and shareable documentation site instantly. Clariodocs is a powerful tool designed for developers to effortlessly convert OpenAPI specs and Postman Collections into beautiful, interactive documentation. |
4 | | - |
5 | | - |
6 | | - |
7 | | -## 🚀 Features |
8 | | - |
9 | | -- **Easy API Spec Upload**: Upload your OpenAPI (JSON/YAML) or Postman collection in seconds. |
10 | | -- **AI-Powered Enhancement**: Automatically generate clear descriptions, functional code examples, and usage patterns using advanced LLMs (e.g., Anthropic Claude 3.5 Sonnet via OpenRouter). |
11 | | -- **Beautiful Documentation UI**: Get a modern, responsive interface complete with dark mode support. |
12 | | -- **Multiple Templates**: Choose from Minimal, Developer Hub, Enterprise, or Interactive templates to match your audience's needs. |
13 | | -- **Interactive Editor**: Tweak and edit your generated documentation in a split-pane interactive Monaco Editor. |
14 | | -- **Custom Domain Support**: Host on our platform or bring your own domain for a seamless, branded experience. |
15 | | -- **Export Options**: Download your generated documentation as PDF or ZIP files. |
16 | | - |
17 | | -## 💻 Tech Stack |
18 | | - |
19 | | -- **Framework**: [Next.js 15.2](https://nextjs.org/) (React 19) |
20 | | -- **Styling**: [Tailwind CSS v4](https://tailwindcss.com/) with Framer Motion, Radix UI primitives, and custom Glowing Effects |
21 | | -- **Authentication & Database**: [Supabase](https://supabase.com/) |
22 | | -- **AI Generation**: [OpenRouter](https://openrouter.ai/) for LLM integration |
23 | | -- **Editor**: [@monaco-editor/react](https://github.com/suren-atoyan/monaco-react) & MDX |
24 | | -- **Drag & Drop**: [@dnd-kit](https://dndkit.com/) |
25 | | - |
26 | | -## 📂 Project Structure |
27 | | - |
28 | | -```bash |
29 | | -clariodocs-api-documentation-generator/ |
30 | | -├── src/ |
31 | | -│ ├── app/ # Next.js App Router (pages layout & routing) |
32 | | -│ │ ├── (dashboard)/ # Main app dashboard, document generation, and editor |
33 | | -│ │ ├── api/ # API Routes for database and OpenRouter calls |
34 | | -│ │ └── ... |
35 | | -│ ├── components/ # Reusable UI components (sections, layouts, MDX elements) |
36 | | -│ ├── hooks/ # Custom React hooks |
37 | | -│ ├── lib/ # Service functions (Supabase client, docService, OpenRouter) |
38 | | -│ ├── provider/ # Global context providers |
39 | | -│ ├── services/ # Business logic and external API integrations |
40 | | -│ └── types/ # TypeScript type definitions |
41 | | -├── public/ # Static assets (images, icons) |
42 | | -├── package.json # NPM dependencies and scripts |
43 | | -└── next.config.ts # Next.js configuration |
44 | | -``` |
45 | | - |
46 | | -## 🛠️ Getting Started |
47 | | - |
48 | | -Follow these steps to set up the project locally: |
49 | | - |
50 | | -### 1. Clone the repository |
51 | | - |
52 | | -```bash |
53 | | -git clone <repository-url> |
54 | | -cd clariodocs-api-documentation-generator |
55 | | -``` |
56 | | - |
57 | | -### 2. Install Dependencies |
58 | | - |
59 | | -```bash |
60 | | -npm install |
61 | | -``` |
62 | | - |
63 | | -### 3. Environment Variables |
64 | | - |
65 | | -Create a `.env.local` file in the root directory and add the necessary environment variables based on `.env.example`: |
66 | | - |
67 | | -```env |
68 | | -NEXT_PUBLIC_SUPABASE_URL=your_supabase_url |
69 | | -NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key |
70 | | -OPENROUTER_API_KEY=your_openrouter_api_key |
71 | | -``` |
72 | | - |
73 | | -### 4. Run the Development Server |
74 | | - |
75 | | -```bash |
76 | | -npm run dev |
77 | | -``` |
78 | | - |
79 | | -Open [http://localhost:3000](http://localhost:3000) with your browser to see the application. |
80 | | - |
81 | | -## 🤝 Contributing |
82 | | - |
83 | | -Contributions are welcome! Please feel free to submit a Pull Request. |
84 | | - |
85 | | -1. Fork the Project |
86 | | -2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) |
87 | | -3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) |
88 | | -4. Push to the Branch (`git push origin feature/AmazingFeature`) |
89 | | -5. Open a Pull Request |
90 | | - |
91 | | -## 📄 License |
92 | | - |
93 | | -This project is licensed under the MIT License - see the `LICENSE` file for details. |
| 1 | +# api-documentation-generator |
| 2 | +NextJS Hackathon |
0 commit comments