Skip to content

Commit 3142e57

Browse files
committed
2 parents 75a5fb3 + dfeca10 commit 3142e57

1 file changed

Lines changed: 2 additions & 93 deletions

File tree

README.md

Lines changed: 2 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -1,93 +1,2 @@
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-
![Clariodocs Dashboard Hero](public/images/create-beautiful-api.png)
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

Comments
 (0)