264 lines
16 KiB
JSON
264 lines
16 KiB
JSON
{
|
|
"metadata": {
|
|
"title": "Sonic Cloud - Frequently Asked Questions",
|
|
"version": "1.0.0",
|
|
"last_updated": "2025-12-18",
|
|
"description": "Comprehensive FAQ for Sonic Cloud music streaming platform"
|
|
},
|
|
"categories": [
|
|
{
|
|
"category": "Getting Started",
|
|
"questions": [
|
|
{
|
|
"question": "How do I create an account on Sonic Cloud?",
|
|
"answer": "Visit /register and provide your email, a unique username (3-20 characters), and a password (minimum 8 characters). You can optionally add a display name. Once registered, you'll receive a JWT token that logs you in automatically for 7 days.",
|
|
"related_links": ["/register", "/login"],
|
|
"keywords": ["account", "register", "signup", "create"]
|
|
},
|
|
{
|
|
"question": "How do I start listening to music?",
|
|
"answer": "After creating an account, go to the homepage or discovery page. You can browse trending songs, new releases, or search by genre. Click any song to start playing it in the fixed audio player at the bottom of the screen. The player stays with you as you navigate between pages.",
|
|
"related_links": ["/", "/discover/trending", "/discover/new-releases"],
|
|
"keywords": ["listen", "play", "music", "start"]
|
|
},
|
|
{
|
|
"question": "What are the system requirements?",
|
|
"answer": "Sonic Cloud works on any modern web browser that supports HTML5 audio (Chrome, Firefox, Safari, Edge). The platform is responsive and works on desktop, tablet, and mobile devices. You'll need an internet connection to stream music.",
|
|
"related_links": [],
|
|
"keywords": ["requirements", "browser", "compatibility", "device"]
|
|
},
|
|
{
|
|
"question": "What audio formats are supported?",
|
|
"answer": "The platform uses HTML5 audio and supports all standard web audio formats including MP3, AAC, OGG, and WAV. When uploading songs as an artist, ensure your audio files are in one of these formats for best compatibility.",
|
|
"related_links": ["/upload"],
|
|
"keywords": ["format", "audio", "mp3", "file type"]
|
|
},
|
|
{
|
|
"question": "Is Sonic Cloud free to use?",
|
|
"answer": "Yes, Sonic Cloud is currently a free platform for both listeners and artists. You can create an account, listen to music, create playlists, and upload songs without any subscription fees.",
|
|
"related_links": [],
|
|
"keywords": ["free", "cost", "price", "subscription"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"category": "Features",
|
|
"questions": [
|
|
{
|
|
"question": "How do I create and manage playlists?",
|
|
"answer": "Once logged in, click the 'Create Playlist' button in your profile or playlists page. Give it a title, optional description, and choose whether it's public or private. Add songs by clicking the add button on any song card. You can reorder songs by dragging them, and delete playlists you own at any time.",
|
|
"related_links": ["/playlists"],
|
|
"keywords": ["playlist", "create", "organize", "manage"]
|
|
},
|
|
{
|
|
"question": "How do I follow artists and get updates?",
|
|
"answer": "Visit any artist's profile page and you'll see their complete catalog of songs and albums. While the platform doesn't currently have a 'follow' feature with notifications, you can add their songs to your playlists and check their profile regularly for new releases. New releases from all artists appear in the /discover/new-releases page.",
|
|
"related_links": ["/discover/new-releases", "/artist/:id"],
|
|
"keywords": ["follow", "artist", "updates", "subscribe"]
|
|
},
|
|
{
|
|
"question": "How does music discovery work?",
|
|
"answer": "Sonic Cloud offers multiple discovery methods: (1) Trending Songs - songs ranked by play count, (2) New Releases - recently uploaded tracks, (3) Genre Browsing - filter by musical categories like Rock, Jazz, or Electronic, and (4) Search - find specific songs, artists, or albums by name. All public songs are searchable and discoverable.",
|
|
"related_links": ["/discover/trending", "/discover/new-releases", "/discover/genres"],
|
|
"keywords": ["discover", "find", "explore", "browse"]
|
|
},
|
|
{
|
|
"question": "How do I share songs, playlists, or albums?",
|
|
"answer": "Click the share button on any song, playlist, or album page. The system generates a unique shareable link (e.g., /s/aBc123XyZ) that you can copy and send to anyone. Share links work even for private content if you're the owner. The platform tracks how many times your share links are clicked.",
|
|
"related_links": [],
|
|
"keywords": ["share", "link", "send", "social"]
|
|
},
|
|
{
|
|
"question": "Can I download songs for offline playback?",
|
|
"answer": "Currently, Sonic Cloud only supports online streaming. Offline playback is not available in the current version. All songs must be played through the web browser with an internet connection.",
|
|
"related_links": [],
|
|
"keywords": ["offline", "download", "save", "local"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"category": "Technical",
|
|
"questions": [
|
|
{
|
|
"question": "What audio quality can I expect?",
|
|
"answer": "Audio quality depends on the source files uploaded by artists. The platform supports standard web audio formats and streams them at their original quality. There's no compression or transcoding applied during playback, so you'll hear the audio at the quality the artist uploaded it.",
|
|
"related_links": [],
|
|
"keywords": ["quality", "bitrate", "audio", "sound"]
|
|
},
|
|
{
|
|
"question": "Does Sonic Cloud work on mobile browsers?",
|
|
"answer": "Yes, Sonic Cloud is fully responsive and works on mobile browsers (iOS Safari, Chrome, Firefox). The interface adapts to smaller screens with a mobile menu and touch-friendly controls. The audio player remains fixed at the bottom for easy access while browsing.",
|
|
"related_links": [],
|
|
"keywords": ["mobile", "phone", "responsive", "ios", "android"]
|
|
},
|
|
{
|
|
"question": "Is there an API for developers?",
|
|
"answer": "Yes, Sonic Cloud exposes 40 RESTful API endpoints for authentication, songs, playlists, artists, albums, labels, search, sharing, and discovery. All endpoints are documented with their required authentication, request/response formats, and parameters. Use JWT token authentication (Authorization: Bearer <token>) for protected endpoints.",
|
|
"related_links": ["/docs/API_REFERENCE.md"],
|
|
"keywords": ["api", "developer", "integration", "rest"]
|
|
},
|
|
{
|
|
"question": "How secure is my data?",
|
|
"answer": "Passwords are hashed using bcryptjs (10 salt rounds) and never stored in plain text. Authentication uses JWT tokens with 7-day expiration. The database enforces unique constraints on emails and usernames. All API endpoints validate authentication tokens before allowing access to protected resources.",
|
|
"related_links": [],
|
|
"keywords": ["security", "password", "encryption", "privacy"]
|
|
},
|
|
{
|
|
"question": "What technology stack does Sonic Cloud use?",
|
|
"answer": "Sonic Cloud is built with Next.js 16 (React 19) for the frontend, TypeScript for type safety, Tailwind CSS 4 for styling, Prisma ORM with SQLite for the database, and JWT with bcryptjs for authentication. It uses a modern server-side rendering architecture with API routes.",
|
|
"related_links": ["/docs/PROJECT_DOCUMENTATION.md"],
|
|
"keywords": ["technology", "stack", "framework", "built"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"category": "Account & Privacy",
|
|
"questions": [
|
|
{
|
|
"question": "How do I update my profile?",
|
|
"answer": "Log in and go to /profile. You can update your display name, bio, website URL, and avatar image. Your username and email cannot be changed after registration. Changes are saved immediately when you submit the profile form.",
|
|
"related_links": ["/profile"],
|
|
"keywords": ["profile", "edit", "update", "settings"]
|
|
},
|
|
{
|
|
"question": "Can I make my playlists private?",
|
|
"answer": "Yes, when creating or editing a playlist, you can toggle between public and private. Private playlists are only visible to you when logged in. Public playlists can be discovered and viewed by any user. Songs in private playlists remain private even if the songs themselves are public.",
|
|
"related_links": ["/playlists"],
|
|
"keywords": ["privacy", "private", "public", "visibility"]
|
|
},
|
|
{
|
|
"question": "How is my data used?",
|
|
"answer": "Your data is used only to provide the music streaming service. Play counts are tracked to show trending songs. Share link clicks are counted for analytics. Your email is used only for login and password resets. We don't sell or share your personal information with third parties.",
|
|
"related_links": [],
|
|
"keywords": ["data", "privacy", "usage", "information"]
|
|
},
|
|
{
|
|
"question": "How do I reset my password?",
|
|
"answer": "Go to /forgot-password and enter your email. If an account exists with that email, you'll receive a password reset link with a token. Click the link and enter your new password (minimum 8 characters). Reset tokens expire after a set time for security.",
|
|
"related_links": ["/forgot-password"],
|
|
"keywords": ["password", "reset", "forgot", "recover"]
|
|
},
|
|
{
|
|
"question": "Can I delete my account?",
|
|
"answer": "Currently, account deletion must be requested through the platform administrators. Contact support to request account deletion. When deleted, your user data, playlists, and shares will be removed. If you're an artist, your songs and albums will also be deleted.",
|
|
"related_links": [],
|
|
"keywords": ["delete", "remove", "account", "close"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"category": "For Artists",
|
|
"questions": [
|
|
{
|
|
"question": "How do I become an artist on Sonic Cloud?",
|
|
"answer": "After creating a user account, go to /artist/create to set up your artist profile. Provide your artist name, bio, avatar, and optional website URL. Once created, you can start uploading songs immediately. Your artist profile gets a unique URL slug (e.g., /artist/your-name).",
|
|
"related_links": ["/artist/create"],
|
|
"keywords": ["artist", "musician", "become", "creator"]
|
|
},
|
|
{
|
|
"question": "How do I upload songs?",
|
|
"answer": "Go to /upload (must be an artist). Fill in the upload form with: song title, audio file URL, duration (in seconds), cover image URL (optional), album selection, genre tags, description, lyrics, and public/private toggle. The song will appear on your artist profile immediately after upload.",
|
|
"related_links": ["/upload"],
|
|
"keywords": ["upload", "song", "music", "publish"]
|
|
},
|
|
{
|
|
"question": "Can I organize my songs into albums?",
|
|
"answer": "Yes, create albums from your artist dashboard. Each album has a title, release date, album type (ALBUM, EP, or SINGLE), cover art, and description. When uploading songs, select which album they belong to. Albums can contain multiple songs and appear on your artist profile.",
|
|
"related_links": ["/album/create"],
|
|
"keywords": ["album", "organize", "collection", "ep"]
|
|
},
|
|
{
|
|
"question": "How do I track my song performance?",
|
|
"answer": "Each song displays its total play count, which increments every time someone plays it. Visit your artist profile to see play counts across all your songs. You can sort songs by popularity to see which tracks are performing best. Share link analytics show how many times your shared content is clicked.",
|
|
"related_links": ["/artist/:id"],
|
|
"keywords": ["analytics", "stats", "plays", "performance"]
|
|
},
|
|
{
|
|
"question": "Can I join a record label?",
|
|
"answer": "Yes, labels can send you invitations through the platform. You'll receive an invitation with PENDING status, which you can accept or decline. When you accept, your artist profile will be linked to that label, and you'll appear in their roster. Label owners can view aggregate statistics across all their artists.",
|
|
"related_links": ["/label/:id"],
|
|
"keywords": ["label", "record", "sign", "roster"]
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"helpful_tips": [
|
|
"Use the search bar (keyboard shortcut: Cmd/Ctrl + K) for quick navigation",
|
|
"The audio player follows you across pages - keep listening while you browse",
|
|
"Create multiple playlists to organize music by mood, genre, or activity",
|
|
"Share songs directly from the player or song page using the share button",
|
|
"Check the trending page daily to discover what's popular on the platform",
|
|
"Artists: Add detailed descriptions and lyrics to help listeners connect with your music",
|
|
"Use genre tags when uploading songs to help listeners discover your music",
|
|
"Private songs are only visible to you - perfect for drafts or work-in-progress tracks",
|
|
"Albums can be sorted by release date to see an artist's musical evolution",
|
|
"The waveform display lets you jump to any part of a song by clicking on it"
|
|
],
|
|
"glossary_quick_reference": {
|
|
"Artist": "A musician or band that uploads music to the platform",
|
|
"Album": "A collection of songs released together (ALBUM: 8+ tracks, EP: 3-7 tracks, SINGLE: 1-2 tracks)",
|
|
"Playlist": "A custom collection of songs you create, can be public or private",
|
|
"Play Count": "Total number of times a song has been played by all users",
|
|
"Share Token": "A unique code (e.g., aBc123XyZ) used in shareable links",
|
|
"Slug": "URL-friendly version of a name (e.g., 'The Beatles' becomes 'the-beatles')",
|
|
"JWT": "JSON Web Token - secure authentication method that remembers you're logged in",
|
|
"Genre": "Music category like Rock, Jazz, Hip-Hop, or Electronic",
|
|
"Waveform": "Visual representation of audio showing loudness over time",
|
|
"Public/Private": "Public content is visible to everyone; private is only visible to you",
|
|
"Verified Badge": "Checkmark showing an artist is officially recognized",
|
|
"Label": "Music organization that manages multiple artists (like a record company)"
|
|
},
|
|
"troubleshooting": {
|
|
"common_issues": [
|
|
{
|
|
"issue": "Song won't play or audio player shows error",
|
|
"solutions": [
|
|
"Check your internet connection",
|
|
"Ensure your browser supports HTML5 audio",
|
|
"Try refreshing the page",
|
|
"Clear browser cache and cookies",
|
|
"Try a different browser"
|
|
]
|
|
},
|
|
{
|
|
"issue": "Can't upload songs as an artist",
|
|
"solutions": [
|
|
"Ensure you've created an artist profile first",
|
|
"Check that you're logged in",
|
|
"Verify audio file URL is accessible",
|
|
"Ensure duration is greater than 0",
|
|
"Check that selected genres exist"
|
|
]
|
|
},
|
|
{
|
|
"issue": "Search not showing results",
|
|
"solutions": [
|
|
"Wait for search to complete (300ms debounce)",
|
|
"Try a different search term",
|
|
"Search requires at least 2 characters",
|
|
"Ensure you're searching for public content",
|
|
"Check spelling and try variations"
|
|
]
|
|
},
|
|
{
|
|
"issue": "JWT token expired (401 error)",
|
|
"solutions": [
|
|
"Log in again to get a new token",
|
|
"Tokens expire after 7 days for security",
|
|
"Ensure you're not logged out",
|
|
"Check browser console for authentication errors"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
"contact_support": {
|
|
"message": "For additional questions not covered in this FAQ, please contact the Sonic Cloud development team or check the full documentation at /docs/PROJECT_DOCUMENTATION.md",
|
|
"documentation_links": {
|
|
"Full Documentation": "/docs/PROJECT_DOCUMENTATION.md",
|
|
"API Reference": "/docs/API_REFERENCE.md",
|
|
"Quick Reference": "/docs/QUICK_REFERENCE.md",
|
|
"Component Catalog": "/docs/COMPONENTS.md"
|
|
}
|
|
}
|
|
}
|