🚀 Your gateway to the SORA ecosystem and DeFi innovation. 🚀

Soranauts is a comprehensive content platform built with Astro 5.16 + Tailwind CSS that provides expert analysis, guides, and insights into the SORA blockchain ecosystem, DeFi protocols, and the future of decentralized finance.

• ✅ Production-ready scores in PageSpeed Insights reports.
• ✅ SORA-focused content covering XOR, VAL, PSWAP tokens and ecosystem developments.
• ✅ Fast and SEO friendly blog with automatic RSS feed, MDX support, Categories & Tags, Social Share.
• ✅ Image Optimization (using new Astro Assets and Unpic for Universal image CDN).
• ✅ DeFi & Blockchain guides for traders, developers, and crypto enthusiasts.
• ✅ Open Graph tags for social media sharing and structured data for search engines.
• ✅ Analytics built-in Google Analytics, and Splitbee integration.

🌐 https://soranauts.com

Soranauts provides comprehensive coverage of the SORA ecosystem, including:

• SORA v3 updates and blockchain innovations
• Polkaswap DEX guides and trading strategies
• Token analysis for XOR, VAL, and PSWAP
• DeFi protocols and investment strategies
• Blockchain technology comparisons and guides

Before you begin, ensure you have the following installed:

• Node.js 20.x — Download
• pnpm 9.x — Install with npm install -g pnpm

Soranauts is built using Astro 5.16 + Tailwind CSS for optimal performance and SEO. The platform focuses on delivering high-quality content about the SORA ecosystem with a clean, fast-loading interface.

The site uses minimal JavaScript for core functionality while maintaining excellent performance scores and SEO optimization for maximum discoverability of SORA-related content.

After cloning, build artifacts must be generated before the dev server or IDE will work:

pnpm install
pnpm generate:glossary && pnpm web:tags:build

These files are gitignored because they are regenerated by the prebuild hook during pnpm build. Running the commands above creates them for local development.

Soranauts is organized as a pnpm monorepo with the following structure:

/
├── apps/
│   └── web/                    # Main Astro web application
│       ├── src/
│       │   ├── components/
│       │   │   ├── glossary/   # Interactive glossary components
│       │   │   ├── tools/      # React islands for tools
│       │   │   ├── blog/
│       │   │   ├── common/
│       │   │   ├── ui/
│       │   │   └── widgets/
│       │   ├── content/
│       │   │   ├── post/       # Blog articles (MDX)
│       │   │   └── glossary/   # Glossary terms (MDX)
│       │   ├── data/
│       │   │   └── taxonomy.ts # Master glossary definitions
│       │   ├── pages/
│       │   │   ├── glossary/
│       │   │   ├── tools/
│       │   │   └── api/
│       │   └── types/
│       ├── public/
│       │   └── data/
│       │       └── glossary.v2025.json
│       └── package.json
├── packages/
│   ├── chain/                  # Blockchain facade
│   ├── config/                 # Shared configurations
│   └── ui/                     # Shared UI components
├── knowledge_base/             # RAG knowledge base system
├── scripts/                    # Build and utility scripts
├── package.json                # Root package.json
├── pnpm-workspace.yaml
└── README.md

Key Features:

• Monorepo Architecture: Shared packages for chain interactions, configurations, and UI components
• React Islands: Interactive components using Astro's React integration
• Glossary System: 384 terms with Pagefind search and category filtering
• API Endpoints: Rate-limited endpoints for blockchain interactions

All commands are run from the root of the project, from a terminal:

Content & Glossary:

Knowledge Base:

Deployment:

Basic configuration file: ./apps/web/src/config.yaml

For detailed configuration options, see the Astro documentation.

Soranauts includes an advanced RAG (Retrieval-Augmented Generation) knowledge base system that powers content discovery and intelligent search features.

Key Features:

• Multi-source ingestion: Automatically syncs content from Medium, SORA Wiki, GitHub, and other sources
• Semantic search: ChromaDB-powered vector search for intelligent content retrieval
• Quality testing: Built-in backtesting to ensure retrieval accuracy
• Automated workflows: GitHub Actions for continuous knowledge base updates

For detailed documentation, see knowledge_base/README.md.

Pagefind Search:

The site uses Pagefind for static search functionality. The search index is automatically built during pnpm build and requires no additional configuration. The index includes all blog posts, glossary terms, and documentation pages.

You can create an optimized production build with:

pnpm build

Now, your website is ready to be deployed. All generated files are located at apps/web/dist folder, which you can deploy to any hosting service you prefer.

Soranauts is configured for Vercel deployment. Connect your GitHub repository to Vercel for automatic deployments on push.

Soranauts specializes in comprehensive coverage of:

• SORA v3 blockchain innovations and updates
• Polkaswap DEX features and trading strategies
• Token analysis for XOR, VAL, and PSWAP
• Governance and decentralized decision-making

• Decentralized exchanges comparison and guides
• Investment strategies for crypto portfolios
• Market analysis and price predictions
• Risk management and security best practices

• 384 SORA ecosystem terms with comprehensive definitions
• Pagefind-powered search with instant results
• 18 categories: Accounts & Identity, Consensus, Cryptography, Data Availability, DeFi, Developer Experience, Economics, Ecosystem, Execution, Governance, Network, Networking, Observability & Operations, Serialization & Encoding, Storage, Technology, Token, Use Cases
• Auto-linking in blog posts with tooltips
• Deep linking support for direct term access

• Polkadot ecosystem and parachain technology
• Consensus mechanisms (Proof of Stake vs Proof of Work)
• Smart contracts and development guides
• Cross-chain interoperability

• ✅ Interactive Glossary - 384 terms with Pagefind search and category filtering
• ✅ React Islands Architecture - Implemented Astro React islands for interactive components
• ✅ Monorepo Structure - Migrated to pnpm monorepo with shared packages and configurations
• ✅ API Endpoints - Added rate-limited quote API with proper error handling
• ✅ Fixed canonical URL bug - Resolved incorrect canonical URL generation that was causing SEO issues
• ✅ Fixed breadcrumb schema - Corrected structured data for better search engine understanding
• ✅ Enhanced mobile menu - Improved spacing and indentation for better user experience
• ✅ SEO optimization - Added proper robots meta tags and pagination handling

• ✅ 45 articles covering SORA ecosystem and DeFi topics
• ✅ Chronological update checklist for maintaining content freshness
• ✅ Category organization for better content discovery
• ✅ Social media integration for content sharing

• Phase chronology & notes
• Phase 14 release checklist
• Feature flag reference

• SORA Network - The official SORA blockchain network
• Polkaswap - Decentralized exchange on SORA
• SORA Wiki - Comprehensive SORA ecosystem documentation

We welcome contributions to improve Soranauts! Whether you want to:

• 📝 Write content about SORA ecosystem developments
• 🐛 Report bugs or suggest improvements
• 🔧 Fix technical issues or enhance functionality
• 📊 Improve SEO or performance
• 🎨 Enhance design or user experience

Please feel free to open a discussion, create an issue, or submit a pull request. Your contributions help make Soranauts the go-to resource for SORA ecosystem information.

Soranauts was originally built on the AstroWind template and has since evolved into a comprehensive SORA ecosystem resource. Special thanks to the SORA ecosystem team for their innovative blockchain technology and the contributors who help make this platform a valuable resource for the community.

Soranauts is licensed under the MIT license — see the LICENSE file for details.