Awesome

Build SEO-friendly websites, super fast full-stack web applications, and much more with Elegant.

👩🏻‍💻 Developer Ready: An all-in-one web application and blogging solution. All the features you need are included right out of the box.

💰 Simple Hosting: Deploy your application on the latest and most affordable serverless tech. No need for any complicated server setups or vendor-locked services.

📰 Data Management: Seamless integration with PostgreSQL and Prisma, with simplified database management that allows you to focus on building your application.

🖼️ Content Creation: Create amazing content with a next-level rich text editor. Perfect for writing blog posts, user guides, and documentation.

✅ Professional Themes: Use our professionally crafted themes that are built with Tailwind CSS, or create your own.

📡 3rd Party Services: Connect up your favorite services and grow your audience. Analytics services, Newsletter Subscription providers, and more.

Table of Contents

• What is Elegant?
• Screenshot
• Demo
• Install
• Configuration
• Hosting and Deployments
• Creating Content
• Growing Your Audience
  • Analytics
  • Newsletter Subscriptions
• Features
  • Database Support
  • Sitemaps
  • Robots.txt
  • Rich Snippets
• Full Documentation
• Community
• Contributing
  • Feature Suggestions
  • Reporting Issues
  • Good First Issues
• Stay Up-To-Date
• License

<a name="what-is-elegant">What is Elegant?</a>

Elegant is a community-driven project for building, deploying, and maintaining websites easily.

Built with Next.js, Tailwind CSS, TipTap, and more. Elegant is perfect for blogging, documentation websites, or just about any type of web application.

<a name="screenshot">Screenshot</a>

<a name="demo">Demo</a>

With Base Theme

Note: The demo below is for Elegant version 3. The demo will be updated with version 4 shortly.

Online Demo - Version 3: https://demo.myelegant.app/

Admin Demo - Version 3: https://demo.myelegant.app/admin

<a name="install">Install</a>

To get started using Elegant, simply install our CLI tool:

npm install elegant-cli

Next, run the initialization command to create your website:

npx elegant-init

Visit https://www.elegantframework.com/docs/installation for the complete installation guide.

<a name="configuration">Configuration</a>

<a name="deploying">Hosting and Deployments</a>

Deploying your Elegant application to production is a breeze with Vercel or any other serverless hosting provider.

Because Elegant is built with the lightweight Next.js framework, your application will run ultra-fast, and at the most affordable monthly hosting costs.

Read the full Elegant Deployment Guide.

<a name="creating_content">Creating Content</a>

Elegant gives you complete control over your content creation experience with an included content editor for creating and editing documents.

The content editor is where you will write content, add images, and links, and even embed YouTube videos.

Read the complete guide on Creating Content here.

<a name="growing_your_audience">Growing Your Audience</a>

We have taken care of most of the boilerplate setup code needed to launch the perfect web application so that you can focus on what is important to you.

Growing your audience is simple with our included native integrations into the most commonly used 3rd party services.

<a name="analytics">Analytics</a>

Track your website traffic, and measure your traffic sources to understand which marketing and social channels are most effective.

Google Analytics is automatically configured with all new Elegant applications, so you can start tracking your web application user traffic immediately.

To start using Google Analytics with your Elegant application, simply provide a Google Analytics ID string to the NEXT_PUBLIC_GOOGLE_ANALYTICS_ID environment variable in your .env file.

NEXT_PUBLIC_GOOGLE_ANALYTICS_ID="G-4G410MD92K"

<a name="newsletter_subscriptions">Newsletter Subscriptions</a>

Elegant makes it easy to grow your email subscriber lists with included newsletter sign-up templates, and native subscription services.

ConvertKit is automatically configured with all new Elegant applications so you may start using it immediately.

If you are interested in using ConvertKit with your Elegant application, you may simply provide an action URL string to the NEXT_PUBLIC_CONVERTKIT_ACTION_URL environment variable in your .env file.

NEXT_PUBLIC_CONVERTKIT_ACTION_URL="https://app.convertkit.com/forms/21224410/subscriptions"

<a name="features">Features</a>

<a name="database_support">Serverless Database Support</a>

With this framework, you can easily integrate your Next.js app with a range of serverless databases, including AWS Aurora Serverless, Google Cloud SQL, Vercel Storage, Neon, and Supabase. By leveraging Prisma and Postgres, you can choose the best storage solution for your needs and enjoy cost-effective, scalable data storage that adapts to your application's demands.

<a name="sitemaps">Sitemaps</a>

A sitemap is a special file that helps search engines like Google understand the structure of a website. It’s like a map that shows all the pages on a website and how they’re connected to each other.

Elegant is configured right out of the box to generate a sitemap.xml file for your web application automatically.

To learn more, view the complete Sitemap Guide Here.

<a name="robots_txt">Robots.txt</a>

A robots.txt file is a simple text file that tells search engine crawlers which parts of your web application they are allowed to access and index.

Elegant is configured right out of the box to generate a robots.txt for your web application automatically.

Below is a snippet of our robots.txt for our documentation website.

# *
User-agent: *
Allow: /

# Host
Host: https://www.elegantframework.com

# Sitemaps
Sitemap: https://www.elegantframework.com/sitemap.xml

To learn more, view the complete Robots.txt Guide Here.

<a name="rich_snippets">Rich Snippets</a>

Rich snippets are a way to provide additional information about a webpage to search engines, like Google, so that they can better understand the content and context of the page. This information can then be displayed in search engine results, making it easier for users to understand what the page is about and whether it’s relevant to their search query.

We have built Elegant to automatically add the most essential Rich Snippets to your web pages.

<a name="documentation">Full Documentation</a>

You can find the complete version of the Elegant documentation at https://elegantframework.com/docs

<a name="community">Community</a>

The Elegant community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects.

To chat with other community members you can join the Elegant Discord.

Our Code of Conduct applies to all Elegant community channels.

<a name="contributing">Contributing</a>

We've built Elegant because we feel that developers should be more empowered to create better websites and content. We hope that other startups and organizations can benefit from the project. We are thankful for any contributions from the community.

If you're interested in contributing to the Elegant project, please read our contributing docs before submitting a pull request.

<a name="feature_suggestions">Feature Suggestions</a>

Elegant is a community-driven project, and open to all suggestions and ideas that help to empower developers everywhere.

Visit our Feature Request page to submit your feedback.

<a name="reporting_issues">Reporting Issues</a>

Bugs and user friction are our top priority. If you experience any issues or friction during your experience with Elegant, please submit a Bug Report.

<a name="good_first_issues">Good First Issues</a>

We have a list of good first issues that contain bugs and features that have a relatively limited scope. This is a great place to get started, gain experience, and get familiar with our contribution process.

<a name="stay_up_to_date">Stay Up-To-Date</a>

The Elegant project is constantly evolving and improving daily. You can keep up and show your support by hitting the Star button! We appreciate it! 😊

<a name="license">License</a>

The Elegant Framework is open-sourced software licensed under the MIT license.