|
1 | | -# CodinIT.dev Docs |
| 1 | +# Mintlify Starter Kit |
2 | 2 |
|
3 | | -This repository contains the official documentation for **CodinIT**, an AI-powered full-stack development platform that revolutionizes how developers build applications with local and cloud AI models. |
| 3 | +Use the starter kit to get your docs deployed and ready to customize. |
4 | 4 |
|
5 | | -## 🚀 What is CodinIT? |
| 5 | +Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with |
6 | 6 |
|
7 | | -CodinIT is a comprehensive development environment that integrates AI assistance throughout the entire development workflow. It supports 19+ AI providers including OpenAI, Anthropic, Google, DeepSeek, and more, offering: |
| 7 | +- Guide pages |
| 8 | +- Navigation |
| 9 | +- Customizations |
| 10 | +- API reference pages |
| 11 | +- Use of popular components |
8 | 12 |
|
9 | | -- **Smart Code Generation**: AI-powered code completion and generation |
10 | | -- **Full-Stack Development**: Built for Node.js full-stack applications |
11 | | -- **Multiple AI Providers**: Connect with your preferred AI models |
12 | | -- **Integrated Tools**: Terminal, file management, and deployment |
13 | | -- **Local Model Support**: Run AI models locally with Ollama and LM Studio |
14 | | -- **Enterprise Security**: Bank-level security and compliance |
| 13 | +**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)** |
15 | 14 |
|
16 | | -## 📚 Documentation Structure |
| 15 | +## Development |
17 | 16 |
|
18 | | -This documentation site is built with [Mintlify](https://mintlify.com) and covers: |
| 17 | +Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command: |
19 | 18 |
|
20 | | -- **Getting Started**: Quickstart guides and installation |
21 | | -- **Features**: Development tools, AI integration, and workflows |
22 | | -- **Providers**: Configuration for 19+ AI providers |
23 | | -- **Integrations**: Vercel, Netlify, Supabase, and Git |
24 | | -- **MCP Protocol**: Extending capabilities with custom tools |
25 | | -- **Comparisons**: How CodinIT compares to other platforms |
26 | | - |
27 | | -## 🛠️ Development Setup |
28 | | - |
29 | | -### Prerequisites |
30 | | - |
31 | | -- Node.js 18+ |
32 | | -- pnpm, npm, or yarn |
33 | | - |
34 | | -> **Important**: If you have a package named `mint` and a package named `mintlify` installed, you should uninstall `mintlify`. |
35 | | -> |
36 | | -> 1. Uninstall the old package: |
37 | | -> |
38 | | -> ```bash |
39 | | -> npm uninstall -g mintlify |
40 | | -> ``` |
41 | | -> |
42 | | -> 2. Clear your npm cache: |
43 | | -> |
44 | | -> ```bash |
45 | | -> npm cache clean --force |
46 | | -> ``` |
47 | | -> |
48 | | -> 3. Reinstall the new package: |
49 | | -> ```bash |
50 | | -> npm i -g mint |
51 | | -> ``` |
52 | | -
|
53 | | -### Local Development |
54 | | -
|
55 | | -1. **Clone the repository** |
56 | | -
|
57 | | - ```bash |
58 | | - git clone https://github.com/codinit-dev/docs.git |
59 | | - cd docs |
60 | | - ``` |
61 | | -
|
62 | | -2. **Install dependencies** |
63 | | - |
64 | | - ```bash |
65 | | - # Using pnpm (recommended) |
66 | | - pnpm install |
67 | | - |
68 | | - # Or using npm |
69 | | - npm install |
70 | | - |
71 | | - # Or using yarn |
72 | | - yarn install |
73 | | - ``` |
74 | | - |
75 | | -3. **Start the development server** |
76 | | - |
77 | | - ```bash |
78 | | - # Using pnpm |
79 | | - pnpm dev |
80 | | - |
81 | | - # Or using npm |
82 | | - npm run dev |
83 | | - |
84 | | - # Or using yarn |
85 | | - yarn dev |
86 | | - ``` |
87 | | - |
88 | | -4. **Open your browser** to `http://localhost:3000` |
89 | | - |
90 | | -### Building for Production |
91 | | - |
92 | | -```bash |
93 | | -# Build the documentation site |
94 | | -pnpm build |
95 | | - |
96 | | -# Preview the production build |
97 | | -pnpm preview |
| 19 | +``` |
| 20 | +npm i -g mint |
98 | 21 | ``` |
99 | 22 |
|
100 | | -## 📝 Contributing |
101 | | - |
102 | | -We welcome contributions to improve the documentation! Here's how you can help: |
103 | | - |
104 | | -### Content Contributions |
105 | | - |
106 | | -1. **Fork** this repository |
107 | | -2. **Create a feature branch**: `git checkout -b feature/your-feature-name` |
108 | | -3. **Make your changes** to the MDX files in the appropriate directories |
109 | | -4. **Test your changes** locally with `pnpm dev` |
110 | | -5. **Commit your changes** following conventional commit format |
111 | | -6. **Push to your fork** and create a **Pull Request** |
112 | | - |
113 | | -### Documentation Guidelines |
114 | | - |
115 | | -- Use clear, concise language |
116 | | -- Include code examples where helpful |
117 | | -- Follow the existing MDX structure and component usage |
118 | | -- Test all links and ensure they're working |
119 | | -- Use proper heading hierarchy (H1 → H2 → H3) |
120 | | - |
121 | | -### File Structure |
| 23 | +Run the following command at the root of your documentation, where your `docs.json` is located: |
122 | 24 |
|
123 | 25 | ``` |
124 | | -docs/ |
125 | | -├── index.mdx # Homepage |
126 | | -├── quickstart.mdx # Getting started guide |
127 | | -├── features/ # Feature documentation |
128 | | -├── providers/ # AI provider guides |
129 | | -├── integrations/ # Third-party integrations |
130 | | -├── essentials/ # Core functionality |
131 | | -├── mcp/ # MCP protocol docs |
132 | | -├── comparisons/ # Platform comparisons |
133 | | -├── running-models-locally/ # Local AI setup |
134 | | -└── assets/ # Images, icons, and media |
| 26 | +mint dev |
135 | 27 | ``` |
136 | 28 |
|
137 | | -## 🔧 Configuration |
138 | | - |
139 | | -The documentation is configured through `docs.json`: |
140 | | - |
141 | | -- **Theme**: Aspen theme with custom colors |
142 | | -- **Navigation**: Organized into logical tabs and groups |
143 | | -- **SEO**: Optimized for search engines |
144 | | -- **Integrations**: Telemetry and analytics enabled |
| 29 | +View your local preview at `http://localhost:3000`. |
145 | 30 |
|
146 | | -## 📄 License |
| 31 | +## Publishing changes |
147 | 32 |
|
148 | | -This documentation is part of the CodinIT project. See the main project [LICENSE](LICENSE) for details. |
| 33 | +Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch. |
149 | 34 |
|
150 | | -## 🌐 Links |
| 35 | +## Need help? |
151 | 36 |
|
152 | | -- **CodinIT App**: [codinit.dev](https://codinit.dev) |
153 | | -- **Documentation**: [codinit.dev/docs](https://codinit.dev/docs) |
154 | | -- **GitHub Repository**: [github.com/codinit-dev/codinit-dev](https://github.com/codinit-dev/codinit-dev) |
155 | | -- **Download**: [codinit.dev/download](https://codinit.dev/download) |
156 | | -- **Blog**: [codinit.dev/blog](https://codinit.dev/blog) |
| 37 | +### Troubleshooting |
157 | 38 |
|
158 | | -## 📞 Support |
| 39 | +- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI. |
| 40 | +- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`. |
159 | 41 |
|
160 | | -- **Issues**: [GitHub Issues](https://github.com/codinit-dev/codinit-dev/issues) |
161 | | -- **Discussions**: [GitHub Discussions](https://github.com/codinit-dev/codinit-dev/discussions) |
162 | | -- **Community**: Join our Discord community for real-time help |
| 42 | +### Resources |
| 43 | +- [Mintlify documentation](https://mintlify.com/docs) |
0 commit comments