diff --git a/api-reference/endpoint/get.mdx b/api-reference/endpoint/get.mdx deleted file mode 100644 index afb1e3a..0000000 --- a/api-reference/endpoint/get.mdx +++ /dev/null @@ -1,309 +0,0 @@ ---- -title: "Get User" -api: "GET https://api.astrio.dev/v1/users/{id}" -description: "Retrieve a specific user by their ID" ---- - -Retrieve detailed information about a specific user in your Astrio application. - -## Path Parameters - - - The unique identifier of the user to retrieve - - -## Query Parameters - - - Comma-separated list of related resources to include. Options: `profile`, `posts`, `settings` - - - - Comma-separated list of fields to include in the response - - -## Response - - - Indicates if the request was successful - - - - - - Unique identifier for the user - - - - The user's full name - - - - The user's email address - - - - The user's role. Options: `user`, `admin`, `moderator` - - - - The user's current status. Options: `active`, `inactive`, `suspended` - - - - - - URL to the user's avatar image - - - - The user's biography - - - - The user's location - - - - The user's website URL - - - - - - ISO 8601 timestamp of when the user was created - - - - ISO 8601 timestamp of when the user was last updated - - - - - - - - ISO 8601 timestamp of the response - - - - API version used - - - - - - -```bash cURL -curl -X GET \ - "https://api.astrio.dev/v1/users/123?include=profile" \ - -H "Authorization: Bearer YOUR_API_KEY" \ - -H "Content-Type: application/json" -``` - -```javascript JavaScript -const response = await fetch('https://api.astrio.dev/v1/users/123?include=profile', { - method: 'GET', - headers: { - 'Authorization': 'Bearer YOUR_API_KEY', - 'Content-Type': 'application/json' - } -}); - -const data = await response.json(); -console.log(data); -``` - -```python Python -import requests - -url = "https://api.astrio.dev/v1/users/123" -headers = { - "Authorization": "Bearer YOUR_API_KEY", - "Content-Type": "application/json" -} - -params = { - "include": "profile" -} - -response = requests.get(url, headers=headers, params=params) -data = response.json() -print(data) -``` - -```php PHP - -``` - - - - - -```json Response -{ - "success": true, - "data": { - "id": "123", - "name": "John Doe", - "email": "john.doe@example.com", - "role": "user", - "status": "active", - "profile": { - "avatar": "https://cdn.astrio.dev/avatars/123.jpg", - "bio": "Software developer passionate about building great products.", - "location": "San Francisco, CA", - "website": "https://johndoe.dev" - }, - "created_at": "2024-01-15T10:30:00Z", - "updated_at": "2024-01-20T14:45:00Z" - }, - "meta": { - "timestamp": "2024-01-25T09:15:30Z", - "version": "1.0" - } -} -``` - - - -## Error Responses - - - -```json 404 - User Not Found -{ - "success": false, - "error": { - "code": "USER_NOT_FOUND", - "message": "The requested user could not be found", - "details": { - "user_id": "123" - } - }, - "meta": { - "timestamp": "2024-01-25T09:15:30Z", - "version": "1.0" - } -} -``` - -```json 401 - Unauthorized -{ - "success": false, - "error": { - "code": "UNAUTHORIZED", - "message": "Authentication credentials are missing or invalid", - "details": { - "hint": "Include a valid API key in the Authorization header" - } - }, - "meta": { - "timestamp": "2024-01-25T09:15:30Z", - "version": "1.0" - } -} -``` - -```json 403 - Forbidden -{ - "success": false, - "error": { - "code": "FORBIDDEN", - "message": "You do not have permission to access this user", - "details": { - "user_id": "123", - "required_permission": "users:read" - } - }, - "meta": { - "timestamp": "2024-01-25T09:15:30Z", - "version": "1.0" - } -} -``` - - - -## Examples - -### Basic User Retrieval - -Get basic user information without any related data: - - - -```bash cURL -curl -X GET \ - "https://api.astrio.dev/v1/users/123" \ - -H "Authorization: Bearer YOUR_API_KEY" -``` - -```javascript JavaScript -const user = await fetch('https://api.astrio.dev/v1/users/123', { - headers: { - 'Authorization': 'Bearer YOUR_API_KEY' - } -}).then(res => res.json()); -``` - - - -### User with Profile Data - -Include the user's profile information in the response: - - - -```bash cURL -curl -X GET \ - "https://api.astrio.dev/v1/users/123?include=profile" \ - -H "Authorization: Bearer YOUR_API_KEY" -``` - -```javascript JavaScript -const userWithProfile = await fetch('https://api.astrio.dev/v1/users/123?include=profile', { - headers: { - 'Authorization': 'Bearer YOUR_API_KEY' - } -}).then(res => res.json()); -``` - - - -### Specific Fields Only - -Retrieve only specific fields to reduce response size: - - - -```bash cURL -curl -X GET \ - "https://api.astrio.dev/v1/users/123?fields=id,name,email" \ - -H "Authorization: Bearer YOUR_API_KEY" -``` - -```javascript JavaScript -const userFields = await fetch('https://api.astrio.dev/v1/users/123?fields=id,name,email', { - headers: { - 'Authorization': 'Bearer YOUR_API_KEY' - } -}).then(res => res.json()); -``` - - \ No newline at end of file diff --git a/api-reference/introduction.mdx b/api-reference/introduction.mdx deleted file mode 100644 index 75b85c2..0000000 --- a/api-reference/introduction.mdx +++ /dev/null @@ -1,257 +0,0 @@ ---- -title: 'API Reference' -description: 'Complete reference for the Astrio API' ---- - -## Overview - -The Astrio API provides a comprehensive set of endpoints for building and managing your applications. All API endpoints return JSON and use standard HTTP response codes. - -## Base URL - -All API requests should be made to: - -``` -https://api.astrio.dev/v1 -``` - -For development and testing: - -``` -http://localhost:3000/api/v1 -``` - -## Authentication - -The Astrio API uses API keys for authentication. Include your API key in the `Authorization` header: - -```bash -curl -H "Authorization: Bearer YOUR_API_KEY" \ - https://api.astrio.dev/v1/users -``` - -### Getting Your API Key - - - - Navigate to your [Astrio Dashboard](https://dashboard.astrio.dev) - - - Click on "API Keys" in the settings menu - - - Click "Generate API Key" and copy the key securely - - - - -Store your API keys securely and never expose them in client-side code. Use environment variables in production. - - -## Rate Limiting - -API requests are rate limited to ensure fair usage: - -| Plan | Requests per minute | Requests per hour | -|------|--------------------|--------------------| -| Free | 60 | 1,000 | -| Pro | 300 | 10,000 | -| Enterprise | 1,000 | 50,000 | - -Rate limit headers are included in all responses: - -``` -X-RateLimit-Limit: 1000 -X-RateLimit-Remaining: 999 -X-RateLimit-Reset: 1640995200 -``` - -## Response Format - -All API responses follow a consistent format: - -### Success Response - -```json -{ - "success": true, - "data": { - "id": 123, - "name": "John Doe", - "email": "john@example.com" - }, - "meta": { - "timestamp": "2024-01-15T10:30:00Z", - "version": "1.0" - } -} -``` - -### Error Response - -```json -{ - "success": false, - "error": { - "code": "VALIDATION_ERROR", - "message": "The provided email address is invalid", - "details": { - "field": "email", - "value": "invalid-email" - } - }, - "meta": { - "timestamp": "2024-01-15T10:30:00Z", - "version": "1.0" - } -} -``` - -## HTTP Status Codes - -The API uses standard HTTP status codes: - -| Code | Description | -|------|-------------| -| 200 | OK - Request successful | -| 201 | Created - Resource created successfully | -| 204 | No Content - Request successful, no content returned | -| 400 | Bad Request - Invalid request parameters | -| 401 | Unauthorized - Authentication required | -| 403 | Forbidden - Insufficient permissions | -| 404 | Not Found - Resource not found | -| 429 | Too Many Requests - Rate limit exceeded | -| 500 | Internal Server Error - Server error | - -## Pagination - -List endpoints support pagination using cursor-based pagination: - -### Request Parameters - -```bash -GET /api/v1/users?limit=20&cursor=eyJpZCI6MTIzfQ== -``` - -| Parameter | Type | Description | -|-----------|------|-------------| -| `limit` | integer | Number of items to return (max 100, default 20) | -| `cursor` | string | Cursor for pagination | - -### Response Format - -```json -{ - "success": true, - "data": [ - { - "id": 123, - "name": "John Doe", - "email": "john@example.com" - } - ], - "pagination": { - "has_more": true, - "next_cursor": "eyJpZCI6MTQ0fQ==", - "total_count": 1500 - } -} -``` - -## Filtering and Sorting - -Most list endpoints support filtering and sorting: - -### Filtering - -```bash -GET /api/v1/users?filter[status]=active&filter[role]=admin -``` - -### Sorting - -```bash -GET /api/v1/users?sort=created_at&order=desc -``` - -## Webhooks - -Astrio can send webhook notifications for various events. Configure webhooks in your dashboard. - -### Webhook Format - -```json -{ - "event": "user.created", - "data": { - "id": 123, - "name": "John Doe", - "email": "john@example.com" - }, - "timestamp": "2024-01-15T10:30:00Z", - "signature": "sha256=..." -} -``` - -### Verifying Webhooks - -```javascript -const crypto = require('crypto'); - -function verifyWebhook(payload, signature, secret) { - const expectedSignature = crypto - .createHmac('sha256', secret) - .update(payload, 'utf8') - .digest('hex'); - - return `sha256=${expectedSignature}` === signature; -} -``` - -## SDKs and Libraries - -Official SDKs are available for popular programming languages: - - - - ```bash - npm install @astrio/sdk - ``` - - - ```bash - pip install astrio-python - ``` - - - ```bash - composer require astrio/php-sdk - ``` - - - ```bash - gem install astrio - ``` - - - -## Getting Started - - - - Generate an API key from your dashboard - - - Try a simple GET request to verify authentication - - - Browse the available endpoints in the navigation - - - Start building your integration using the API - - - - -For detailed examples and interactive testing, use our [API Explorer](https://api-explorer.astrio.dev) tool. - \ No newline at end of file diff --git a/assets/favicon.svg b/assets/favicon.svg new file mode 100644 index 0000000..20e7fe0 --- /dev/null +++ b/assets/favicon.svg @@ -0,0 +1,31 @@ + + + + + + + \ No newline at end of file diff --git a/assets/images/astrio_landing_page.png b/assets/images/astrio_landing_page.png new file mode 100644 index 0000000..6ed0a92 Binary files /dev/null and b/assets/images/astrio_landing_page.png differ diff --git a/assets/logos/logo_icon_black.png b/assets/logos/logo_icon_black.png new file mode 100644 index 0000000..95ffa92 Binary files /dev/null and b/assets/logos/logo_icon_black.png differ diff --git a/assets/logos/logo_icon_white.png b/assets/logos/logo_icon_white.png new file mode 100644 index 0000000..72230d4 Binary files /dev/null and b/assets/logos/logo_icon_white.png differ diff --git a/assets/logos/logo_transparent_black.png b/assets/logos/logo_transparent_black.png new file mode 100644 index 0000000..b73f45c Binary files /dev/null and b/assets/logos/logo_transparent_black.png differ diff --git a/assets/logos/logo_transparent_white.png b/assets/logos/logo_transparent_white.png new file mode 100644 index 0000000..891379d Binary files /dev/null and b/assets/logos/logo_transparent_white.png differ diff --git a/development.mdx b/development.mdx deleted file mode 100644 index 426d45c..0000000 --- a/development.mdx +++ /dev/null @@ -1,234 +0,0 @@ ---- -title: 'Development' -description: 'Learn how to develop and customize your Astrio applications' ---- - -## Development Environment - -Set up your local development environment for building Astrio applications. - -### Prerequisites - -Make sure you have the following installed on your system: - - - - Version 18.0 or higher - - - For version control - - - -### Project Structure - -Understanding your Astrio project structure: - -``` -my-astrio-app/ -├── src/ -│ ├── components/ # Reusable UI components -│ ├── layouts/ # Page layouts -│ ├── pages/ # Application pages -│ ├── styles/ # CSS and styling -│ └── utils/ # Utility functions -├── public/ # Static assets -├── astrio.config.js # Astrio configuration -└── package.json # Dependencies -``` - -## Development Workflow - -### Hot Reload - -Astrio provides instant hot reload during development: - -```bash -astrio dev --hot -``` - -Changes to your code will automatically refresh in the browser. - -### Environment Variables - -Configure environment-specific settings: - - - -```bash .env.local -# Database -DATABASE_URL=postgresql://localhost:5432/myapp - -# Authentication -AUTH_SECRET=your-secret-key -GOOGLE_CLIENT_ID=your-google-client-id - -# API Keys -STRIPE_PUBLIC_KEY=pk_test_... -STRIPE_SECRET_KEY=sk_test_... -``` - -```javascript astrio.config.js -export default { - env: { - // Public variables (available in browser) - public: { - APP_NAME: process.env.APP_NAME, - API_URL: process.env.API_URL, - }, - // Private variables (server-only) - private: { - DATABASE_URL: process.env.DATABASE_URL, - AUTH_SECRET: process.env.AUTH_SECRET, - } - } -} -``` - - - -## Debugging - -### Development Tools - -Access Astrio's built-in development tools: - -- **Component Inspector**: Hover over components to see their properties -- **Route Debugger**: View routing information and parameters -- **Database Query Monitor**: Track database queries and performance -- **API Request Logger**: Monitor API calls and responses - -### Logging - -Add logging to your application: - -```javascript -import { logger } from '@astrio/utils'; - -// Different log levels -logger.info('User logged in', { userId: 123 }); -logger.warn('API rate limit approaching'); -logger.error('Database connection failed', error); - -// In production, logs are automatically sent to your dashboard -``` - -## Testing - -### Unit Testing - -Astrio includes built-in testing utilities: - -```javascript -import { test, expect } from '@astrio/test'; -import { render } from '@astrio/test-utils'; -import { MyComponent } from '../components/MyComponent'; - -test('renders component correctly', () => { - const { getByText } = render(); - expect(getByText('Hello World')).toBeInTheDocument(); -}); -``` - -### Integration Testing - -Test your API endpoints: - -```javascript -import { testApi } from '@astrio/test'; - -test('creates user successfully', async () => { - const response = await testApi.post('/api/users', { - name: 'John Doe', - email: 'john@example.com' - }); - - expect(response.status).toBe(201); - expect(response.data.id).toBeDefined(); -}); -``` - -### Run Tests - -```bash -# Run all tests -astrio test - -# Run tests in watch mode -astrio test --watch - -# Run tests with coverage -astrio test --coverage -``` - -## Performance Optimization - -### Code Splitting - -Astrio automatically handles code splitting, but you can optimize further: - -```javascript -// Lazy load components -const HeavyComponent = lazy(() => import('./HeavyComponent')); - -// Dynamic imports for routes -const AdminPanel = lazy(() => import('../pages/admin')); -``` - -### Image Optimization - -Use Astrio's built-in image optimization: - -```jsx -Hero image -``` - -### Caching Strategies - -Configure caching for optimal performance: - -```javascript -// astrio.config.js -export default { - cache: { - // Static assets cache for 1 year - static: '1y', - // API responses cache for 5 minutes - api: '5m', - // Page cache for 1 hour - pages: '1h' - } -} -``` - -## Best Practices - - - - - Keep components small and focused - - Use TypeScript for better development experience - - Follow consistent naming conventions - - Create reusable component libraries - - - - - Use local state for component-specific data - - Leverage Astrio's built-in global state for app-wide data - - Consider performance implications of state updates - - Implement proper error boundaries - - - - - Follow RESTful conventions - - Implement proper error handling - - Use input validation and sanitization - - Document your APIs thoroughly - - \ No newline at end of file diff --git a/essentials/code.mdx b/essentials/code.mdx deleted file mode 100644 index b1dae26..0000000 --- a/essentials/code.mdx +++ /dev/null @@ -1,459 +0,0 @@ ---- -title: 'Code Examples' -description: 'Learn how to write and organize code in your Astrio applications' ---- - -## Code Organization - -Astrio promotes clean, maintainable code through well-defined patterns and conventions. - -### Component Structure - -Follow these patterns when creating components: - -```jsx -// components/UserCard.jsx -import { useState } from 'react'; -import { Card, Avatar, Button } from '@astrio/ui'; - -export function UserCard({ user, onEdit, onDelete }) { - const [isLoading, setIsLoading] = useState(false); - - const handleEdit = async () => { - setIsLoading(true); - try { - await onEdit(user.id); - } finally { - setIsLoading(false); - } - }; - - return ( - -
- -
-

{user.name}

-

{user.email}

-
-
- - -
-
- - ); -} -``` - -### API Routes - -Create robust API endpoints with proper error handling: - -```javascript -// pages/api/users/[id].js -import { db } from '@astrio/database'; -import { auth } from '@astrio/auth'; - -export default async function handler(req, res) { - // Authentication check - const user = await auth.getUser(req); - if (!user) { - return res.status(401).json({ error: 'Unauthorized' }); - } - - const { id } = req.query; - - try { - switch (req.method) { - case 'GET': - return await getUser(id, res); - case 'PUT': - return await updateUser(id, req.body, res); - case 'DELETE': - return await deleteUser(id, res); - default: - res.setHeader('Allow', ['GET', 'PUT', 'DELETE']); - return res.status(405).json({ error: 'Method not allowed' }); - } - } catch (error) { - console.error('API Error:', error); - return res.status(500).json({ error: 'Internal server error' }); - } -} - -async function getUser(id, res) { - const user = await db.user.findUnique({ - where: { id: parseInt(id) }, - select: { id: true, name: true, email: true, createdAt: true } - }); - - if (!user) { - return res.status(404).json({ error: 'User not found' }); - } - - return res.status(200).json(user); -} - -async function updateUser(id, data, res) { - const { name, email } = data; - - // Validation - if (!name || !email) { - return res.status(400).json({ error: 'Name and email are required' }); - } - - const user = await db.user.update({ - where: { id: parseInt(id) }, - data: { name, email }, - }); - - return res.status(200).json(user); -} - -async function deleteUser(id, res) { - await db.user.delete({ - where: { id: parseInt(id) } - }); - - return res.status(204).end(); -} -``` - -### Database Operations - -Use Astrio's database utilities for clean data access: - -```javascript -// utils/database.js -import { db } from '@astrio/database'; - -export class UserService { - static async create(userData) { - return await db.user.create({ - data: { - ...userData, - createdAt: new Date(), - }, - }); - } - - static async findById(id) { - return await db.user.findUnique({ - where: { id }, - include: { - posts: true, - profile: true, - }, - }); - } - - static async update(id, data) { - return await db.user.update({ - where: { id }, - data: { - ...data, - updatedAt: new Date(), - }, - }); - } - - static async delete(id) { - // Soft delete - return await db.user.update({ - where: { id }, - data: { - deletedAt: new Date(), - isActive: false, - }, - }); - } - - static async list(options = {}) { - const { page = 1, limit = 10, search } = options; - - const where = { - isActive: true, - ...(search && { - OR: [ - { name: { contains: search, mode: 'insensitive' } }, - { email: { contains: search, mode: 'insensitive' } }, - ], - }), - }; - - const [users, total] = await Promise.all([ - db.user.findMany({ - where, - skip: (page - 1) * limit, - take: limit, - orderBy: { createdAt: 'desc' }, - }), - db.user.count({ where }), - ]); - - return { - users, - pagination: { - page, - limit, - total, - pages: Math.ceil(total / limit), - }, - }; - } -} -``` - -### Form Handling - -Create forms with validation and error handling: - -```jsx -// components/UserForm.jsx -import { useState } from 'react'; -import { useForm } from '@astrio/forms'; -import { Input, Button, Alert } from '@astrio/ui'; - -export function UserForm({ user, onSubmit }) { - const [isSubmitting, setIsSubmitting] = useState(false); - const [error, setError] = useState(null); - - const { register, handleSubmit, formState: { errors } } = useForm({ - defaultValues: { - name: user?.name || '', - email: user?.email || '', - role: user?.role || 'user', - }, - validation: { - name: { - required: 'Name is required', - minLength: { value: 2, message: 'Name must be at least 2 characters' }, - }, - email: { - required: 'Email is required', - pattern: { - value: /^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$/i, - message: 'Invalid email address', - }, - }, - }, - }); - - const onSubmitForm = async (data) => { - setIsSubmitting(true); - setError(null); - - try { - await onSubmit(data); - } catch (err) { - setError(err.message || 'An error occurred'); - } finally { - setIsSubmitting(false); - } - }; - - return ( -
- {error && ( - - {error} - - )} - -
- -
- -
- -
- -
- -
- - -
- ); -} -``` - -### Custom Hooks - -Create reusable logic with custom hooks: - -```javascript -// hooks/useApi.js -import { useState, useEffect } from 'react'; - -export function useApi(endpoint, options = {}) { - const [data, setData] = useState(null); - const [loading, setLoading] = useState(true); - const [error, setError] = useState(null); - - const { dependencies = [], method = 'GET' } = options; - - useEffect(() => { - let isCancelled = false; - - const fetchData = async () => { - try { - setLoading(true); - setError(null); - - const response = await fetch(endpoint, { - method, - headers: { - 'Content-Type': 'application/json', - }, - ...options, - }); - - if (!response.ok) { - throw new Error(`HTTP error! status: ${response.status}`); - } - - const result = await response.json(); - - if (!isCancelled) { - setData(result); - } - } catch (err) { - if (!isCancelled) { - setError(err.message); - } - } finally { - if (!isCancelled) { - setLoading(false); - } - } - }; - - fetchData(); - - return () => { - isCancelled = true; - }; - }, [endpoint, ...dependencies]); - - const refetch = () => { - setLoading(true); - setError(null); - // Trigger useEffect by updating a dependency - }; - - return { data, loading, error, refetch }; -} - -// Usage example -function UserList() { - const { data: users, loading, error, refetch } = useApi('/api/users'); - - if (loading) return
Loading...
; - if (error) return
Error: {error}
; - - return ( -
- - {users.map(user => ( - - ))} -
- ); -} -``` - -### Environment Configuration - -Manage environment-specific settings: - -```javascript -// config/index.js -const config = { - development: { - apiUrl: 'http://localhost:3000/api', - dbUrl: 'postgresql://localhost:5432/astrio_dev', - logLevel: 'debug', - }, - production: { - apiUrl: 'https://api.astrio.dev', - dbUrl: process.env.DATABASE_URL, - logLevel: 'error', - }, - test: { - apiUrl: 'http://localhost:3001/api', - dbUrl: 'postgresql://localhost:5432/astrio_test', - logLevel: 'silent', - }, -}; - -const env = process.env.NODE_ENV || 'development'; - -export default config[env]; -``` - -## Best Practices - - - - - Always handle errors gracefully - - Provide meaningful error messages - - Log errors for debugging - - Use try-catch blocks appropriately - - Implement global error boundaries - - - - - Use React.memo for expensive components - - Implement proper loading states - - Optimize database queries - - Use caching where appropriate - - Lazy load heavy components - - - - - Validate all user inputs - - Sanitize data before database operations - - Use HTTPS in production - - Implement proper authentication - - Follow OWASP security guidelines - - \ No newline at end of file diff --git a/essentials/images.mdx b/essentials/images.mdx deleted file mode 100644 index 0521e6d..0000000 --- a/essentials/images.mdx +++ /dev/null @@ -1,275 +0,0 @@ ---- -title: 'Images' -description: 'Learn how to add and optimize images in your Astrio documentation' ---- - -## Adding Images - -You can add images to your documentation in several ways using standard Markdown syntax or HTML. - -### Markdown Syntax - -```markdown -![Alt text](/images/example.png) -``` - -### HTML with Classes - -```html -Example -``` - -### Responsive Images - -Use responsive image classes for better mobile experience: - -```html -Hero image -``` - -## Image Organization - -Organize your images in the `images` directory: - -``` -docs/ -├── images/ -│ ├── screenshots/ -│ │ ├── dashboard.png -│ │ └── settings.png -│ ├── logos/ -│ │ ├── light.svg -│ │ └── dark.svg -│ ├── icons/ -│ │ ├── check.svg -│ │ └── warning.svg -│ └── hero.png -``` - -## Dark Mode Support - -Provide different images for light and dark themes: - -```html -Hero Light -Hero Dark -``` - -## Image Optimization - -### Recommended Formats - -- **PNG**: For screenshots, UI elements, and images with transparency -- **JPG**: For photographs and complex images -- **SVG**: For logos, icons, and simple graphics -- **WebP**: For modern browsers (fallback to PNG/JPG) - -### File Size Guidelines - -| Type | Recommended Size | Max Size | -|------|------------------|----------| -| Icons | 24x24 to 64x64px | 5KB | -| Screenshots | 800-1200px wide | 200KB | -| Hero images | 1200-1920px wide | 500KB | -| Thumbnails | 200-400px wide | 50KB | - -### Compression Tools - -- **Online**: TinyPNG, ImageOptim, Squoosh -- **CLI**: `imagemin`, `sharp` -- **Build tools**: webpack-image-loader, vite-plugin-imagemin - -## Screenshots and UI Elements - -### Best Practices for Screenshots - -1. **Use consistent browser/OS**: Chrome on macOS for consistency -2. **Hide sensitive data**: Use placeholder content -3. **Crop appropriately**: Focus on relevant UI elements -4. **Use annotations**: Highlight important areas - -### Example Screenshot - -```html -
- Astrio Dashboard Screenshot -
-``` - -## Icons and Graphics - -### Using SVG Icons - -```html -
- - - - Feature enabled -
-``` - -### Icon Libraries - -Popular icon libraries that work well with Mintlify: - -- **Heroicons**: Simple, beautiful SVG icons -- **Lucide**: Clean, customizable icons -- **Feather**: Minimalist icons -- **Font Awesome**: Comprehensive icon set - -## Image Galleries - -### Simple Gallery - -```html -
- Image 1 - Image 2 - Image 3 -
-``` - -### Gallery with Captions - -```html -
-
- Feature 1 -
- Dashboard overview with real-time metrics -
-
-
- Feature 2 -
- User management interface -
-
-
-``` - -## Video and GIFs - -### Embedding Videos - -```html -
- -
-``` - -### Animated GIFs - -Use GIFs sparingly for short demonstrations: - -```html -Feature demonstration -``` - -## Accessibility - -### Alt Text Guidelines - -- **Descriptive**: Describe what's in the image -- **Concise**: Keep it under 125 characters -- **Context-aware**: Consider surrounding content -- **Skip decorative**: Use empty alt="" for decorative images - -### Examples - -```html - -User dashboard showing 5 active projects and recent activity - - -dashboard - - - -``` - -## Performance Tips - -### Lazy Loading - -```html -Large image -``` - -### Progressive Enhancement - -```html - - - - Hero image - -``` - -### CDN Integration - -For production, consider using a CDN: - -```html -Hero image -``` - -## Troubleshooting - - - - - Check the file path is correct - - Ensure the image exists in the `images` directory - - Verify file permissions - - Check for typos in the filename - - - - - Compress the image using optimization tools - - Consider using WebP format - - Implement lazy loading - - Use appropriate dimensions - - - - - Verify you're using the correct CSS classes - - Check that both light and dark images exist - - Ensure proper naming convention - - Test in both themes - - \ No newline at end of file diff --git a/essentials/markdown.mdx b/essentials/markdown.mdx deleted file mode 100644 index 8523d13..0000000 --- a/essentials/markdown.mdx +++ /dev/null @@ -1,232 +0,0 @@ ---- -title: 'Markdown' -description: 'Learn how to use Markdown in your Astrio documentation' ---- - -## MDX Support - -Astrio documentation supports MDX, which allows you to use JSX components directly in your Markdown files. - -### Basic Markdown - -You can use all standard Markdown syntax: - -```markdown -# Heading 1 -## Heading 2 -### Heading 3 - -**Bold text** and *italic text* - -- Unordered list item -- Another item - - Nested item - -1. Ordered list item -2. Another ordered item - -[Link text](https://example.com) - -`inline code` -``` - -### Code Blocks - -Syntax highlighting is automatically applied: - -````markdown -```javascript -function greet(name) { - return `Hello, ${name}!`; -} -``` - -```python -def greet(name): - return f"Hello, {name}!" -``` - -```bash -npm install astrio-cli -``` -```` - -### Interactive Components - -Use Astrio's built-in components for enhanced documentation: - -#### Cards - -```jsx - - - Quick start guide for new users - - - Complete API documentation - - -``` - - - - Quick start guide for new users - - - Complete API documentation - - - -#### Accordions - -```jsx - - - Astrio is a platform for building applications quickly. - - - Follow our quickstart guide to begin building. - - -``` - - - - Astrio is a platform for building applications quickly. - - - Follow our quickstart guide to begin building. - - - -#### Steps - -```jsx - - - Install the Astrio command line interface - - - Generate a new Astrio project - - - Deploy your application to production - - -``` - - - - Install the Astrio command line interface - - - Generate a new Astrio project - - - Deploy your application to production - - - -### Callouts - -Use callouts to highlight important information: - - -This is a note callout for general information. - - - -This is a tip callout for helpful suggestions. - - - -This is a warning callout for important notices. - - - -This is an info callout for additional details. - - -```jsx - -This is a note callout for general information. - - - -This is a tip callout for helpful suggestions. - - - -This is a warning callout for important notices. - - - -This is an info callout for additional details. - -``` - -### Math Support - -Astrio supports LaTeX math notation: - -Inline math: $E = mc^2$ - -Block math: -$$ -\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} -$$ - -```markdown -Inline math: $E = mc^2$ - -Block math: -$$ -\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} -$$ -``` - -### Tables - -| Feature | Description | Status | -| ------- | ----------- | ------ | -| Authentication | User login/logout | ✅ Complete | -| Database | Data persistence | ✅ Complete | -| API Routes | REST endpoints | 🚧 In Progress | -| Payments | Stripe integration | ⏳ Planned | - -### Custom Components - -You can create and use custom React components: - -```jsx -import { CustomButton } from '../components/CustomButton'; - - - Click me! - -``` - -### Best Practices - - - - - Use clear headings to organize information - - Break up long sections with subheadings - - Use bullet points and numbered lists - - Include code examples where relevant - - - - - Use Cards to group related links - - Implement Steps for processes - - Add Accordions for optional details - - Include callouts for important information - - - - - Use consistent formatting across pages - - Follow the same structure for similar content - - Use appropriate callout types - - Maintain consistent code formatting - - \ No newline at end of file diff --git a/features/overview.mdx b/features/overview.mdx new file mode 100644 index 0000000..5d35b0b --- /dev/null +++ b/features/overview.mdx @@ -0,0 +1,172 @@ +--- +title: 'Features Overview' +description: 'Discover the powerful features that make Astrio the fastest way to build applications' +--- + +## Why Choose Astrio? + +Astrio revolutionizes application development by combining the power of AI with intuitive no-code tools. Build production-ready applications in minutes, not months. + + + + Visual drag-and-drop interface for rapid application development + + + Intelligent code generation and optimization suggestions + + + Deploy to production with automatic scaling and SSL + + + Work together with your team in real-time + + + +## Core Capabilities + +### 🎨 Visual Development + +Build beautiful, responsive applications using our intuitive visual editor: + +- **Drag & Drop Components**: Pre-built UI components for rapid development +- **Responsive Design**: Automatic mobile optimization +- **Custom Styling**: Full control over appearance and branding +- **Theme System**: Light/dark mode and custom themes + +### 🤖 AI Integration + +Leverage artificial intelligence to accelerate your development: + +- **Smart Code Generation**: AI writes code based on your descriptions +- **Intelligent Suggestions**: Get recommendations for improvements +- **Auto-completion**: AI-powered code completion and error detection +- **Natural Language Queries**: Describe what you want and let AI build it + +### 🚀 Performance & Scale + +Built for performance from day one: + +- **Edge Deployment**: Global CDN for lightning-fast load times +- **Auto-scaling**: Handles traffic spikes automatically +- **Optimized Builds**: Automatic code splitting and optimization +- **Real-time Updates**: Instant deployments with zero downtime + +### 🔒 Enterprise Ready + +Secure and reliable for business applications: + +- **SOC 2 Compliant**: Enterprise-grade security standards +- **SSO Integration**: Single sign-on with popular providers +- **Role-based Access**: Granular permissions and user management +- **Audit Logs**: Complete activity tracking and compliance + +## Development Workflow + + + + Start with our visual builder or import designs from Figma + + + Add functionality with our component library and AI assistance + + + Integrate with databases, APIs, and third-party services + + + Push to production with one click and automatic optimization + + + +## Feature Comparison + +| Feature | Traditional Development | Astrio | +|---------|------------------------|---------| +| **Setup Time** | Days to weeks | Minutes | +| **Coding Required** | Extensive | Minimal to none | +| **Deployment** | Complex CI/CD setup | One-click deploy | +| **Scaling** | Manual configuration | Automatic | +| **Maintenance** | Ongoing updates | Managed for you | +| **Team Collaboration** | Git conflicts | Real-time editing | + +## What You Can Build + + + + - SaaS platforms and dashboards + - E-commerce stores + - Content management systems + - Customer portals + - Internal tools and admin panels + + + + - Progressive Web Apps (PWAs) + - Native mobile applications + - Cross-platform solutions + - Mobile-first experiences + + + + - CRM systems + - Project management tools + - Inventory management + - HR and payroll systems + - Analytics dashboards + + + + - RESTful APIs + - GraphQL endpoints + - Microservices + - Webhook handlers + - Data processing pipelines + + + +## Getting Started + +Ready to experience the future of application development? + + + + See Astrio in action with our interactive demo + + + Follow our quickstart guide to build your first app + + + Browse pre-built templates and examples + + + + +Astrio is designed to grow with you - from simple prototypes to enterprise applications handling millions of users. + \ No newline at end of file diff --git a/integrations/overview.mdx b/integrations/overview.mdx new file mode 100644 index 0000000..f78fba7 --- /dev/null +++ b/integrations/overview.mdx @@ -0,0 +1,286 @@ +--- +title: 'Integrations Overview' +description: 'Connect Astrio with your favorite tools and services to build powerful applications' +--- + +## Seamless Connections + +Astrio integrates with hundreds of popular services and APIs, allowing you to build feature-rich applications without starting from scratch. Connect your existing tools and data sources with just a few clicks. + + + + PostgreSQL, MySQL, MongoDB, Supabase, and more + + + Google, GitHub, Auth0, Firebase Auth, and custom providers + + + Stripe, PayPal, Square, and other payment processors + + + REST APIs, GraphQL, webhooks, and custom integrations + + + +## Popular Integrations + +### 💾 Data & Storage + +
+
+
+ PG +
+ PostgreSQL +
+
+
+ S +
+ Supabase +
+
+
+ M +
+ MongoDB +
+
+
+ F +
+ Firebase +
+
+
+ R +
+ Redis +
+
+
+ A +
+ Airtable +
+
+ +### 🔐 Authentication Providers + +
+
+
+ G +
+ Google OAuth +
+
+
+ G +
+ GitHub +
+
+
+ M +
+ Microsoft +
+
+
+ A +
+ Auth0 +
+
+
+ O +
+ Okta +
+
+
+ D +
+ Discord +
+
+ +### 💳 Payment Processing + +
+
+
+ S +
+ Stripe +
+
+
+ P +
+ PayPal +
+
+
+ S +
+ Square +
+
+
+ R +
+ Razorpay +
+
+ +## Integration Categories + + + + - **Slack** - Team notifications and bot integrations + - **Discord** - Community management and webhooks + - **Twilio** - SMS and voice communications + - **SendGrid** - Email marketing and transactional emails + - **Mailchimp** - Email campaigns and automation + - **Telegram** - Bot development and notifications + + + + - **Google Analytics** - Web analytics and user tracking + - **Mixpanel** - Product analytics and user behavior + - **Segment** - Customer data platform + - **Hotjar** - User session recordings and heatmaps + - **Sentry** - Error tracking and performance monitoring + - **LogRocket** - Session replay and debugging + + + + - **AWS S3** - Scalable object storage + - **Cloudinary** - Image and video management + - **Google Drive** - Document storage and sharing + - **Dropbox** - File synchronization + - **Unsplash** - High-quality stock photos + - **YouTube** - Video embedding and management + + + + - **Notion** - Documentation and knowledge management + - **Airtable** - Flexible database and spreadsheets + - **Zapier** - Workflow automation + - **HubSpot** - CRM and marketing automation + - **Salesforce** - Enterprise CRM + - **Calendly** - Appointment scheduling + + + + - **GitHub** - Code repositories and version control + - **Vercel** - Frontend deployment and hosting + - **Netlify** - Static site hosting + - **Docker** - Containerization + - **Kubernetes** - Container orchestration + - **Postman** - API testing and documentation + + + +## How Integrations Work + + + + Explore our integration marketplace or search for specific services + + + Authenticate with your service using OAuth or API keys + + + Define how data flows between Astrio and your external service + + + Test your integration and deploy to production + + + +## Custom Integrations + +Don't see your service listed? Astrio supports custom integrations through: + +### REST API Integration +Connect any service with a REST API using our visual API builder: +- Custom headers and authentication +- Request/response mapping +- Error handling and retries +- Rate limiting and caching + +### Webhook Support +Receive real-time data from external services: +- Automatic webhook validation +- Custom payload processing +- Event-driven workflows +- Secure endpoint generation + +### GraphQL Connections +Connect to GraphQL APIs with full query support: +- Schema introspection +- Query builder interface +- Subscription support +- Type-safe data handling + +## Enterprise Integrations + +For enterprise customers, we offer: + + + + Build dedicated connectors for your internal systems + + + Connect to services behind your firewall + + + Single sign-on with your identity provider + + + Branded API endpoints for your customers + + + +## Getting Help + +Need assistance with integrations? + + +Our integration team is here to help! Contact support@astrio.build for custom integration requests or technical assistance. + + + +Most integrations can be set up in under 5 minutes using our pre-built connectors and guided setup wizard. + \ No newline at end of file diff --git a/introduction.mdx b/introduction.mdx deleted file mode 100644 index 5e2120b..0000000 --- a/introduction.mdx +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Welcome to Astrio -description: 'Transform your ideas into powerful applications' ---- - -Hero Light -Hero Dark - -## What is Astrio? - -Astrio is a powerful platform that transforms your ideas into fully functional applications. Build, deploy, and scale your projects without writing extensive code. - - - - Get your first Astrio application running in under 5 minutes - - - Explore our comprehensive set of tools and capabilities - - - Integrate Astrio into your existing workflows - - - Join our growing community of developers - - - -## Getting Started - - - - Astrio supports a wide range of applications including: - - Web applications and websites - - Mobile applications - - API services and microservices - - Data analytics dashboards - - E-commerce platforms - - And much more! - - - - While coding experience is helpful, Astrio is designed to be accessible to users of all skill levels. Our visual builder and templates make it easy to get started without extensive programming knowledge. - - - - Astrio provides seamless deployment to various platforms including: - - Cloud providers (AWS, Google Cloud, Azure) - - Edge networks for optimal performance - - Custom domains and SSL certificates - - Automatic scaling based on traffic - - - -## Popular Resources - - - - Learn the fundamentals in minutes - - - Optimize your Astrio applications - - - Start with pre-built solutions - - \ No newline at end of file diff --git a/introduction/faq.mdx b/introduction/faq.mdx new file mode 100644 index 0000000..823b146 --- /dev/null +++ b/introduction/faq.mdx @@ -0,0 +1,258 @@ +--- +title: 'Frequently Asked Questions' +description: 'Common questions about Astrio and no-code development' +--- + +## General Questions + + + + Astrio is an AI-powered no-code platform that allows you to build production-ready applications without writing code. Astrio helps you create everything from simple websites to complex business applications, while also modernizing outdated systems into scalable, future-ready solutions. + + + + Astrio is perfect for: + - **Entrepreneurs** building MVPs and startups + - **Small businesses** creating internal tools + - **Agencies** delivering client projects faster + - **Developers** prototyping ideas quickly + - **Enterprise teams** building custom applications + + No coding experience required! + + + + Astrio stands out with: + - **AI-powered assistance** that helps you build faster + - **True visual development** with no hidden code complexity + - **Professional-grade output** suitable for production use + - **AI-powered modernization** to upgrade outdated websites and legacy codebases into scalable, future-ready applications + - **Seamless integrations** with popular services + - **One-click deployment** to global infrastructure + + + + No! Astrio is designed for users with no coding background. Our visual interface and AI assistant guide you through the entire process. However, if you do have coding experience, you'll find powerful features that let you customize beyond the visual builder. + + + +## Getting Started + + + + Getting started is simple: + 1. **Sign up** for a free account at [astrio.build](https://astrio.build) + 2. **Choose a starting point** whether to build from scratch or modernize an existing application + 3. **Use the visual builder and natural language prompt system** to design your app + 4. **Publish** with one click when ready + + Your first app can be live in under 30 minutes! + + + + Yes! Astrio offers a generous free tier that includes: + - 5 credits everyday + - Basic integrations + - Community support + - Astrio subdomain hosting + + Perfect for trying out the platform and building your first applications. + + + + Absolutely! You can: + - **Import from Figma** using screenshots + - **Upload images** and recreate designs visually + - **Copy and paste** design elements from other tools + + + + Build times vary by complexity. Much faster than traditional development! + + By breaking tasks into smaller steps, planning ahead, and refining based on feedback, you can move quickly while ensuring quality. + + + + +## Features & Capabilities + + + + You can build virtually any web application: + - **Portfolio & Landing Websites**: Personal portfolios, business landing pages, product launch sites + - **Business tools**: CRM, project management, inventory systems + - **E-commerce**: Online stores, marketplaces, subscription services + - **Content platforms**: Blogs, communities, learning management systems + - **SaaS applications**: Multi-tenant software, analytics dashboards + - **Mobile apps**: Progressive web apps that work on any device + + + + Yes! Astrio supports connections to: + - **PostgreSQL**, **MySQL**, **MongoDB** + - **Supabase**, **Firebase**, **Airtable** + - **Google Sheets**, **Notion databases** + - **Custom APIs** and **GraphQL endpoints** + + Set up database connections visually with no configuration files. + + + + Absolutely! Built-in authentication includes: + - **Social logins**: Google, GitHub + - **Email/password** authentication + - **Magic links** for passwordless login + - **Custom SSO** for enterprise customers + - **Role-based permissions** and user management + + + + Yes! Integrated payment processing with: + - **Stripe** for credit cards and digital wallets + + Handle subscriptions, one-time payments, and complex billing scenarios. + + + + Every app built with Astrio is automatically responsive and mobile-optimized: + - **Responsive layouts** adapt to any screen size + - **Touch-friendly interfaces** for mobile interaction + - **Progressive Web App** features for app-like experience + - **Mobile-first design** principles built-in + + + +## AI & Automation + + + + Our AI assistant helps throughout the building process: + - **Describe features** in plain English and watch them get built + - **Get suggestions** for improving your app's design and functionality + - **Auto-generate content** like forms, tables, and workflows + - **Optimize performance** with intelligent recommendations + + + + Yes! Astrio supports integration with: + - **OpenAI GPT models** for text generation and analysis + - **Custom AI endpoints** via API integration + - **Machine learning services** like AWS, Google Cloud AI + - **Computer vision APIs** for image processing + + + +## Deployment & Performance + + + + Deployment is incredibly simple: + 1. Click the **"Publish"** button in your project + 2. Your app is automatically built and optimized + 3. It's deployed to global CDN infrastructure + 4. You get a live URL in under 60 seconds + + No server management or DevOps knowledge required! + + + + Yes! Custom domains are supported: + - **Free subdomains**: yourapp.astrio.build + - **Custom domains**: yourdomain.com (paid plans) + - **SSL certificates** included automatically + - **Global CDN** for fast loading worldwide + + + + Built for performance from the ground up: + - **Automatic optimization** of images, code, and assets + - **Global CDN deployment** for fast loading everywhere + - **Intelligent caching** strategies + - **Edge computing** for dynamic content + - **Performance monitoring** and alerts + + + + Your apps automatically scale to handle traffic: + - **Auto-scaling infrastructure** handles traffic spikes + - **Database optimization** for large datasets + - **Caching layers** for improved performance + - **Load balancing** across multiple servers + - **Enterprise-grade infrastructure** for mission-critical apps + + + +## Pricing & Plans + + + + Flexible pricing for every need: + - **Free**: 1 deployed site, community support + - **Pro ($25/month)**: 10 deployed sites, custom domains, codebase download + - **Business ($100/month)**: 25 deployed sites, collaboration features, priority support + - **Enterprise**: Custom pricing for large organizations + + All plans include hosting and deployment. + + + + The free plan is essentially a permanent trial! You can: + - Recieve 5 credits everyday + - Build and deploy up to 1 application + - Access most features and integrations + - Get community support + - Upgrade anytime for additional features + + + + Yes! You can upgrade or downgrade at any time: + - **Instant upgrades** with immediate access to new features + - **Prorated billing** for mid-month changes + - **Downgrade protection** - existing projects continue working + - **Cancel anytime** with no long-term commitments + + + +## Support & Community + + + + Multiple support channels: + - **Documentation**: Comprehensive guides and tutorials + - **Community Discord**: Get help from other builders + - **Email support**: Direct help from our team + - **Priority support**: Faster response times for paid plans + - **Video calls**: Screen sharing for complex issues (Enterprise) + + + + Yes! Join our active community: + - **Discord server**: Real-time chat and help + - **Community forum**: Long-form discussions and showcases + - **Twitter**: Updates and tips + - **YouTube**: Tutorials and livestreams + - **Regular meetups**: Virtual and in-person events + + + + Multiple learning resources: + - **Interactive tutorials** built into the platform + - **Video course library** for all skill levels + - **Live webinars** and Q&A sessions + - **Personal onboarding** for Enterprise customers + - **Certification program** for advanced users + + + +## Still Have Questions? + +Can't find what you're looking for? We're here to help! + + + + Get instant help from our community and team + + + Send us an email and we'll get back to you quickly + + \ No newline at end of file diff --git a/introduction/getting-started.mdx b/introduction/getting-started.mdx new file mode 100644 index 0000000..4b8ede8 --- /dev/null +++ b/introduction/getting-started.mdx @@ -0,0 +1,167 @@ +--- +title: 'Getting Started' +description: 'Start building with Astrio in minutes' +--- + +## Overview + +This is the step-by-step guide on how to build a full-stack application successfully with Astrio. + +Astrio Platform Overview + +## Quick Setup + + + + Sign up for free at [astrio.build](https://astrio.build) + + + Select whether to build from scratch or modernize an existing application + + + Use our visual builder and natural language prompt system to design and configure your application + + + Launch your app to production with one click + + + +## Your First Project + +### The Lifecycle of an Application + +Every project in Astrio follows a simple flow: + +**Plan & Design → Build or Modernize → Iterate → Publish** + +### Step 1: Plan & Design + +Before you start, think about what you want to create or modernize. + +- **What is it?** (a portfolio website, a business dashboard, an old exisitng website that needs a fresh look) +- **Who is it for?** (yourself, your team, your customers) +- **What should it do?** (list features like “create tasks,” “show charts,” “send notifications”) +- **How should it look?** (clean, modern, playful, professional) + +A little planning goes a long way. Even if you start with a simple idea, having answers to these questions helps Astrio give you better results. + +### Step 2: Start Building or Modernizing + +There are several ways to get started with Astrio, depending on your preferences and resources. + + + + Astrio’s prompt-based system makes app creation and modernization simple. + - Just describe what you want to build in the prompt box. + - The more specific you are, the better the results. + - Start with clear and detailed prompts. + - You can refine and adjust your project as you go. + + + Example: + + "I want to build a landing page for a bakery called Paris Bakery. It’s located in a small college town called Lewisburg, Pennsylvania. The goal of the site is to attract local students, families, and visitors by showing off the bakery’s story, menu, and contact details. Its features should include: a hero section with a warm welcome message, an about section telling the bakery’s story, a menu preview with photos of baked goods, a testimonials section for customer reviews, and a contact section with location, phone, and hours. It should have a cozy, Parisian-inspired aesthetic with warm colors, elegant fonts, and inviting photography. Users should be able to easily browse the menu, read about the bakery, and find directions. The site should be mobile-friendly and fast-loading. Users will access the site in their browser, so make sure it’s suitable for hosting on Netlify." + + + + With Astrio, you can bring in your old codebase in two simple ways: + - Upload it as a ZIP file. + - Connect your GitHub account and link a repository. + + + + + Use a design from [Figma](https://www.figma.com/). + + + Take a screenshot of your Figma design, then paste or drag-and-drop it into Astrio. + + + Our platform will transform your sketch into working code. + + + + + + + Use [Excalidraw](https://excalidraw.com/) or any similar tool to sketch your UI. + + + Take a screenshot of your drawing, then paste or drag-and-drop it into Astrio. + + + Our platform will transform your sketch into working code. + + + + + +### Step 3: Iterate + +After Astrio generates your application from your first prompt, you’ll probably want to make changes: +- Add more features. +- Tweak behavior or appearance. +- Fix bugs. + +Remember. Do one thing at a time. Don’t try to add multiple features in one go. + +### Step 4: Publish + +When you're ready to go live, you can just publish it and get a shareable URL. You can use that URL showcase your application or share it with collaborators and stakeholders. + +## What You Can Build with Astrio + + + + - **Personal Portfolios**: Showcase your work, skills, and achievements + - **Business Landing Pages**: Highlight your brand, products, and services + - **Event Pages**: Promote upcoming events with schedules and registration + - **Product Launch Sites**: Create buzz and capture early customers + + + - **CRM Systems**: Manage customers and sales pipelines + - **Project Management**: Track tasks, teams, and deadlines + - **Inventory Management**: Monitor stock and orders + - **HR Portals**: Employee onboarding and management + + + + - **Online Stores**: Sell products with integrated payments + - **Service Marketplaces**: Connect buyers and sellers + - **Subscription Services**: Recurring billing and management + - **Digital Downloads**: Sell courses, ebooks, software + + + + - **Blogs & Publications**: Content management systems + - **Community Platforms**: Forums and social features + - **Learning Platforms**: Courses and educational content + - **Event Management**: Registration and ticketing + + + + - **Analytics Dashboards**: Data visualization and reporting + - **Workflow Automation**: Business process management + - **API Services**: Backend services and integrations + - **Multi-tenant Applications**: Software as a Service platforms + + + +## Need Help? + + + + Join our Discord community + + + Get help from our team + + + + +Ready to start building? [Create your free account](https://astrio.build) and have your first app running in minutes! + \ No newline at end of file diff --git a/introduction/welcome.mdx b/introduction/welcome.mdx new file mode 100644 index 0000000..077119c --- /dev/null +++ b/introduction/welcome.mdx @@ -0,0 +1,65 @@ +--- +title: Welcome to Astrio +description: 'Transform your ideas into powerful applications' +--- + +## What is Astrio? + +Astrio is a powerful platform that transforms your ideas into fully functional applications. Build, deploy, and scale your projects faster than ever — without writing extensive code. + + + + Get your first Astrio application running in under 5 minutes + + + Discover what you can do with Astrio + + + Connect with databases, APIs, and third-party services + + + Join our community of builders on Discord + + + +## Popular Resources + + + + Learn the fundamentals in minutes + + + Optimize your Astrio applications + + + Start with pre-built solutions + + \ No newline at end of file diff --git a/mint.json b/mint.json index da70d2b..bb9f6c8 100644 --- a/mint.json +++ b/mint.json @@ -2,90 +2,104 @@ "$schema": "https://mintlify.com/schema.json", "name": "Astrio", "logo": { - "dark": "/logo/dark.svg", - "light": "/logo/light.svg" + "dark": "/assets/logos/logo_transparent_white.png", + "light": "/assets/logos/logo_transparent_black.png" }, - "favicon": "/favicon.svg", + "favicon": "/assets/favicon.svg", "colors": { - "primary": "#0D9373", - "light": "#07C983", - "dark": "#0D9373", + "primary": "#3b83f6", + "light": "#3b83f6", + "dark": "#3b83f6", "anchors": { - "from": "#0D9373", - "to": "#07C983" + "from": "#3b83f6", + "to": "#3b83f6" } }, "topbarLinks": [ { - "name": "Support", - "url": "mailto:support@astrio.dev" + "name": "Community", + "url": "https://discord.gg/mMspVRXbNX" } ], "topbarCtaButton": { - "name": "Dashboard", - "url": "https://dashboard.astrio.dev" + "name": "Support", + "url": "mailto:support@astrio.build" }, "tabs": [ { - "name": "API Reference", - "url": "api-reference" + "name": "Introduction", + "url": "introduction" + }, + { + "name": "Features", + "url": "features" + }, + { + "name": "Integrations", + "url": "integrations" } ], "anchors": [ { - "name": "Documentation", - "icon": "book-open-cover", - "url": "https://docs.astrio.dev" + "name": "Updates", + "icon": "x-twitter", + "url": "https://x.com/astrio_ai" }, { "name": "Community", - "icon": "slack", - "url": "https://community.astrio.dev" + "icon": "discord", + "url": "https://discord.gg/mMspVRXbNX" }, { "name": "Blog", "icon": "newspaper", - "url": "https://blog.astrio.dev" + "url": "https://blog.astrio.build" } ], "navigation": [ { - "group": "Get Started", + "group": "Introduction", "pages": [ - "introduction", - "quickstart", - "development" + "introduction/welcome", + "introduction/getting-started", + "introduction/faq" ] }, { - "group": "Essentials", + "group": "Features", "pages": [ - "essentials/markdown", - "essentials/code", - "essentials/images", - "essentials/settings", - "essentials/navigation" + "features/overview", + "features/no-code-builder", + "features/ai-assistance", + "features/deployment", + "features/collaboration" ] }, { - "group": "API Documentation", + "group": "Integrations", "pages": [ - "api-reference/introduction" - ] - }, - { - "group": "API Reference", - "pages": [ - "api-reference/endpoint/get", - "api-reference/endpoint/create", - "api-reference/endpoint/update", - "api-reference/endpoint/delete" + "integrations/overview", + "integrations/databases", + "integrations/authentication", + "integrations/payments", + "integrations/third-party" ] } ], + "feedback": { + "thumbsRating": true, + "suggestEdit": true, + "raiseIssue": true + }, + "github": { + "owner": "astrio-ai", + "repo": "docs" + }, "footerSocials": { - "x": "https://x.com/astrio", - "github": "https://github.com/astrio", - "linkedin": "https://www.linkedin.com/company/astrio" + "x": "https://x.com/astrio_ai", + "linkedin": "https://www.linkedin.com/company/astrioai", + "instagram": "https://www.instagram.com/astrio_ai", + "github": "https://github.com/astrio-ai", + "discord": "https://discord.gg/mMspVRXbNX" } } \ No newline at end of file diff --git a/quickstart.mdx b/quickstart.mdx deleted file mode 100644 index 685c1ce..0000000 --- a/quickstart.mdx +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: 'Quickstart' -description: 'Start building with Astrio in under 5 minutes' ---- - -## Setup your development environment - -Learn how to update your docs locally and and deploy them to the public. - -### Install Astrio CLI - - - -```bash npm -npm install -g astrio-cli -``` - -```bash yarn -yarn global add astrio-cli -``` - -```bash pnpm -pnpm add -g astrio-cli -``` - - - -### Authenticate your account - -After installing the CLI, authenticate with your Astrio account: - -```bash -astrio login -``` - -This will open your browser and prompt you to sign in to your Astrio account. - -## Create your first project - - - - Create a new Astrio project using the CLI: - ```bash - astrio create my-first-app - cd my-first-app - ``` - - - Select from our pre-built templates: - - **Web App**: Full-stack web application - - **API Service**: RESTful API with database - - **Landing Page**: Marketing website - - **Dashboard**: Analytics and data visualization - - **E-commerce**: Online store with payments - - - Launch your application in development mode: - ```bash - astrio dev - ``` - Your app will be available at `http://localhost:3000` - - - -## Make your first changes - - - - -Open `src/pages/index.astro` and modify the content: - -```jsx ---- -title: "My Amazing App" ---- - - - - -``` - - - -Create a new page by adding a file to `src/pages/`: - -```jsx ---- -title: "About Us" ---- - - -
-

About Our Company

-

We're building the future of web development.

-
- -``` - - - -Update `astrio.config.js` to customize your application: - -```javascript -export default { - name: "My Amazing App", - theme: { - colors: { - primary: "#3b82f6", - secondary: "#64748b" - } - }, - features: { - auth: true, - database: true, - payments: false - } -} -``` - - - - -## Deploy your application - -When you're ready to share your application with the world: - - - - ```bash - astrio build - ``` - - - ```bash - astrio deploy - ``` - - - ```bash - astrio domain add yourdomain.com - ``` - - - - -Your application will be automatically deployed with SSL certificates and global CDN for optimal performance. - - -## Next steps - - - - Learn about Astrio's built-in components - - - Connect and manage your data - - - Add user authentication to your app - - - Create and manage API endpoints - - \ No newline at end of file