Common issues and their solutions when setting up AkiraDocs.
Problem: Error about Node.js version compatibility
1Error: The engine "node" is incompatible with this module
Solution:
1. Check your Node.js version:
1node --version
2. Install the correct version (16.x or higher)
3. Use nvm to manage Node.js versions:
1nvm install 20
2nvm use 20
Problem: npm install fails with errors
Solution:
1. Clear npm cache:
1npm cache clean --force
2. Delete node_modules and package-lock.json:
1rm -rf node_modules package-lock.json
2npm install
Problem: `npm run build` fails
Solution:
1. Check for TypeScript errors:
1npm run type-check
2. Verify environment variables are set correctly
3. Clear next.js cache:
1rm -rf .next
Problem: Static export fails with dynamic routes
Solution:
1. Configure `next.config.js`:
1module.exports = {
2 output: 'export',
3 images: {
4 unoptimized: true
5 }
6}
Problem: Automatic translation fails
Solution:
1. Verify API keys are set correctly
2. Check translation configuration:
1{
2 "translation": {
3 "auto_translate": true,
4 "provider": "anthropic",
5 "targetLanguages": ["es", "fr", "de"]
6 }
7}
Problem: Changes to content files not reflecting
Solution:
Content changes are built on build time. If you are using the local development server, you need to restart the server after making changes.
1. Clear the cache:
1npm run clean
2. Restart the development server
3. Check file permissions
Problem: Deployment to Vercel fails
Solution:
1. Check build logs
2. Verify environment variables are set in Vercel dashboard
3. Ensure all dependencies are listed in package.json
If you're still experiencing issues:
1. Check our [GitHub Issues](https://github.com/Cloud-Code-AI/Akiradocs/issues)
2. Join our [Discord Community](https://discord.gg/zvYZukgeH2)
3. Contact [Support](mailto:[email protected])